PIpismo
Merchant transaction

List merchant transactions (V3)

List merchant transactions filtered using query parameters.

get/v3/merchants/{merchantId}/transactions

Request

  • Base URL
    https://sandbox.pismolabs.io/merchants
  • URL
    https://sandbox.pismolabs.io/merchants/v3/merchants/{merchantId}/transactions
  • Auth
    HTTP bearer

Path parameters

merchantIdinteger required
Example:1

Merchant ID

Query parameters

marketplaceIdinteger
Example:1

Marketplace ID

status'PENDING' | 'SCHEDULED' | 'BLOCKED' | 'SETTLED' | 'PAID' | 'ADVANCED' | 'CANCELED' | 'RETURNED'
Example:SCHEDULED

Transaction status

startPaymentDatestring date
Example:2020-01-01

Scheduled payment start date. Find scheduled payments between this date and endPaymentDate. Format = yyyy-mm-dd.

endPaymentDatestring date
Example:2020-01-02

Scheduled payment end date. Format = yyyy-mm-dd. Find scheduled payments between startPaymentDate and this date.

startEventDatestring date
Example:2020-01-01

Date authorization is generated (and associated event emitted). Format is yyyy-mm-dd.

endEventDatestring date
Example:2020-01-02

End date of transaction event. Format is yyyy-mm-dd.

startReceiptDatestring date
Example:2020-01-01

Start date of merchant transaction settlement. Format is yyyy-mm-dd.

endReceiptDatestring date
Example:2020-01-02T00:00:00.000Z

End date of merchant transaction settlement. Format is yyyy-mm-dd.

orgOperationIdinteger
Example:1

Processing code. See <a href="https://developers.pismo.io/pismo-docs/docs/processing-codes-and-transaction-types" target="_blank">Processing codes and transaction types</a>.

sortBystring
Example:paymentDate

Sort field

metastring
Example:MarketplaceTransaction:wquiqw-jwjh-huahu-ashga

Metadata. The accepted parameters are MarketplaceAuthorization and MarketplaceTransaction.

pageinteger
Example:1

Page number. Default is 1.

perPageinteger
Example:10

Items per page. Default is 10.

Headers

Content-Typestring
Example:application/json

Content type

Authorizationstring
Example:Bearer 1JI12J39182H39182JDIOAWJ%=

Authorization token. This is a regular access token, which does not need to include an account ID.

Response

OK

total_itemsinteger

Total number of items

per_pageinteger

Number of items per page

pagesinteger

Number of pages

current_pageinteger

Current page number

Example response

{
  "total_items": 74,
  "per_page": 10,
  "pages": 8,
  "current_page": 1,
  "tax": {
    "mdr": [
      {
        "description": "Merchant Discount Rate",
        "operation_type": 1,
        "mdr": 0.03,
        "days_to_payment": 30
      }
    ]
  },
  "items": [
    {
      "id": 2,
      "type": "SALES",
      "number_of_installments": 3,
      "installment": 2,
      "gross_value": 3600.02,
      "net_value": 3582.02,
      "discount": -18,
      "operation_type": 89,
      "operation": "Credit card without quotas",
      "event_date": "2020-07-14T00:41:29Z",
      "payment_date": "2020-07-16",
      "receipt_date": "2020-07-16",
      "received_value": 0.1,
      "status": "SCHEDULED",
      "meta": [
        {
          "name": "MarketplaceAuthorization",
          "value": "ashga-jwjh-huahu-wquiqw"
        },
        {
          "name": "MarketplaceTransaction",
          "value": "wquiqw-jwjh-huahu-ashga"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.