GET
/
Query
/
transactions
/
{entry}
curl --request GET \
  --url https://api-sandbox.payabli.com/api/Query/transactions/{entry} \
  --header 'requestToken: <api-key>'
{
  "Summary": {
    "totalRecords": 2,
    "totalAmount": 177.22,
    "totalNetAmount": 177.22,
    "totalPages": 1,
    "pageSize": 20,
    "pageIdentifier": "XXXXXXXXXXXXXXXXXXX"
  },
  "Records": [
    {
      "ParentOrgName": "Payabli",
      "PaypointDbaname": "Sunshine LLC",
      "PaypointLegalname": "Sunshine LLC",
      "PaypointEntryname": "7acda8200",
      "PaymentTransId": "2345667-ddd-fff",
      "GatewayTransId": "string",
      "ExternalProcessorInformation": " ",
      "OrderId": "9876543",
      "Method": "card",
      "BatchNumber": "1234567",
      "PayorId": 55,
      "PaymentData": {
        "MaskedAccount": "411111XXXXXX1111",
        "AccountType": "visa",
        "AccountExp": "0426",
        "HolderName": "Billy J Franks",
        "StoredId": "675b43c1-9867-463c-8dc7-3d6ddb68554b-12812",
        "Initiator": "payor",
        "StoredMethodUsageType": "unscheduled",
        "Sequence": "first",
        "orderDescription": null,
        "accountId": null,
        "SignatureData": null,
        "binData": {
          "binMatchedLength": 6,
          "binCardBrand": "VISA",
          "binCardType": "DEBIT",
          "binCardCategory": "CLASSIC",
          "binCardIssuer": "CONOTOXIA SP. Z O.O",
          "binCardIssuerCountry": "POLAND",
          "binCardIssuerCountryCodeA2": "PL",
          "binCardIssuerCountryNumber": 616
        }
      },
      "TransStatus": 1,
      "PaypointId": 2,
      "TotalAmount": 110.25,
      "NetAmount": 100,
      "FeeAmount": 10.25,
      "SettlementStatus": 0,
      "Operation": "Sale",
      "ResponseData": {
        "response": null,
        "responsetext": "CAPTURED",
        "authcode": "00",
        "transactionid": "TRN_xwCAjQorWAYX1nAhAoHZVfN8iYHbI0",
        "avsresponse": null,
        "avsresponse_text": null,
        "cvvresponse": null,
        "cvvresponse_text": null,
        "orderid": null,
        "type": null,
        "response_code": "100",
        "response_code_text": "Transaction was approved.",
        "emv_auth_response_data": null
      },
      "Source": "vterminal",
      "ScheduleReference": 0,
      "OrgId": 2,
      "RefundId": 0,
      "ReturnedId": 0,
      "TransAdditionalData": null,
      "InvoiceData": {
        "invoiceNumber": "INV-2345",
        "invoiceDate": "10/25/2023",
        "invoiceDueDate": "11/25/2023",
        "invoiceType": 0,
        "invoiceEndDate": "string",
        "invoiceStatus": 0,
        "frequency": "one-time",
        "paymentTerms": "PIA",
        "termsConditions": "string",
        "notes": "string",
        "tax": 2.05,
        "discount": 0,
        "invoiceAmount": 105,
        "freightAmount": 10,
        "dutyAmount": 0,
        "purchaseOrder": "string",
        "firstName": "string",
        "lastName": "string",
        "company": "string",
        "shippingAddress1": "string",
        "shippingAddress2": "string",
        "shippingCity": "string",
        "shippingState": "string",
        "shippingZip": "string",
        "shippingCountry": "string",
        "shippingEmail": "string",
        "shippingPhone": "string",
        "shippingFromZip": "string",
        "summaryCommodityCode": "string",
        "items": [
          {
            "itemProductCode": "string",
            "itemProductName": "product 01",
            "itemDescription": "string",
            "itemCommodityCode": "string",
            "itemUnitOfMeasure": "U",
            "itemCost": 1,
            "itemQty": 1,
            "itemMode": 0,
            "itemCategories": [
              "string"
            ],
            "itemTotalAmount": 0,
            "itemTaxAmount": 0,
            "itemTaxRate": 0
          }
        ],
        "attachments": [
          {
            "ftype": "pdf",
            "filename": "my-doc.pdf",
            "furl": "https://mysite.com/my-doc.pdf",
            "fContent": "TXkgdGVzdCBmaWxlHJ==..."
          }
        ],
        "additionalData": {
          "property1": "string",
          "property2": "string"
        }
      },
      "EntrypageId": 0,
      "TransactionTime": "2019-08-24T14:15:22Z",
      "Customer": {
        "customerId": 34,
        "FirstName": "John",
        "LastName": "Doe",
        "CompanyName": "Sunshine LLC",
        "CustomerNumber": "3456-7645A",
        "BillingAddress1": "1111 street",
        "BillingAddress2": "string",
        "BillingCity": "myCity",
        "BillingState": "CA",
        "BillingZip": "45567",
        "BillingCountry": "US",
        "BillingPhone": "1234567890",
        "BillingEmail": "customer@mail.com",
        "ShippingAddress1": "string",
        "ShippingAddress2": "string",
        "ShippingCity": "string",
        "ShippingState": "string",
        "ShippingZip": "string",
        "ShippingCountry": "string",
        "AdditionalData": {
          "property1": "string",
          "property2": "string"
        },
        "CreatedAt": "2019-08-24T14:15:22Z"
      },
      "CfeeTransactions": [
        {
          "cFeeTransid": "string",
          "transStatus": 0,
          "feeAmount": 0,
          "settlementStatus": 0,
          "operation": "string",
          "responseData": null,
          "refundId": 0,
          "transactionTime": "2019-08-24T14:15:22Z"
        }
      ],
      "TransactionEvents": [
        {
          "transEvent": "Approved",
          "eventData": null,
          "eventTime": "2019-08-24T14:15:22Z"
        }
      ],
      "deviceId": "6c361c7d-674c-44cc-b790-382b75d1xxx",
      "AchSecCode": null,
      "AchHolderType": null
    }
  ]
}

By default, this endpoint returns only transactions from the last 60 days. To query transactions outside of this period, include transactionDate filters.

For example, this request parameters filter for transactions between April 01, 2024 and April 09, 2024.

curl --request GET \
  --url https://sandbox.payabli.com/api/Query/transactions/org/1?limitRecord=20&fromRecord=0&transactionDate(ge)=2024-04-01T00:00:00&transactionDate(le)=2024-04-09T23:59:59\
  --header 'requestToken: <api-key>'

You must remove parameters= from the request before you send it, otherwise Payabli will ignore the filters.

Because of a technical limitation, you can’t make a request that includes filters from the API console on this page. The response won’t be filtered. Instead, copy the request, remove parameters= and run the request in a different client.

For example:

—url https://api-sandbox.payabli.com/api/Query/transactions/org/236?parameters=totalAmount(gt)=1000&limitRecord=20

should become:

—url https://api-sandbox.payabli.com/api/Query/transactions/org/236?totalAmount(gt)=1000&limitRecord=20

Authorizations

requestToken
string
header
required

Most endpoints require an organization token. Some endpoints require an application token, and those endpoints are noted.

Path Parameters

entry
string
required

The paypoint's entrypoint identifier. Learn more

Example:

"8cfec329267"

Query Parameters

parameters
object

Collection of field names, conditions, and values used to filter the query.

See Filters and Conditions Reference for more information.

List of field names accepted:

  • transactionDate (gt, ge, lt, le, eq, ne)
  • transId (ne, eq, ct, nct, in, nin)
  • gatewayTransId (ne, eq, ct, nct)
  • orderId (ne, eq)
  • scheduleId (ne, eq)
  • returnId (ne, eq)
  • refundId (ne, eq)
  • idTrans (ne, eq)
  • orgId (ne, eq)
  • paypointId (ne, eq)
  • paypointLegal (ne, eq, ct, nct)
  • paypointDba (ne, eq, ct, nct)
  • orgName (ne, eq, ct, nct)
  • externalPaypointId (ct, nct, eq, ne)
  • method (in, nin, eq, ne)
  • totalAmount (gt, ge, lt, le, eq, ne)
  • netAmount (gt, ge, lt, le, eq, ne)
  • feeAmount (gt, ge, lt, le, eq, ne)
  • operation (in, nin, eq, ne)
  • source (in, nin, eq, ne, ct, nct)
  • status (in, nin, eq, ne)
  • settlementStatus (in, nin, eq, ne)
  • batchNumber (nct, ct)
  • invoiceNumber (ct, nct)
  • authCode (ct, nct)
  • orderDescription (ct, nct)
  • payaccountLastfour (nct, ct)
  • payaccountType (ne, eq, in, nin)
  • payaccountCurrency (ne, eq, in, nin)
  • customerFirstname (ct, nct, eq, ne)
  • customerLastname (ct, nct, eq, ne)
  • customerName (ct, nct)
  • customerId (eq, ne)
  • customerNumber (ct, nct, eq, ne)
  • customerCompanyname (ct, nct, eq, ne)
  • customerAddress (ct, nct, eq, ne)
  • customerCity (ct, nct, eq, ne)
  • customerZip (ct, nct, eq, ne)
  • customerState (ct, nct, eq, ne)
  • customerCountry (ct, nct, eq, ne)
  • customerPhone (ct, nct, eq, ne)
  • customerEmail (ct, nct, eq, ne)
  • customerShippingAddress (ct, nct, eq, ne)
  • customerShippingCity (ct, nct, eq, ne)
  • customerShippingZip (ct, nct, eq, ne)
  • customerShippingState (ct, nct, eq, ne)
  • customerShippingCountry (ct, nct, eq, ne)
  • deviceId (ct, nct, in, nin, eq, ne)
  • AchSecCode ( ct, nct, in, nin, eq, ne)
  • AchHolderType (ct, nct, in, nin, eq, and ne)
  • additional-xxx (ne, eq, ct, nct) where xxx is the additional field name

List of comparison operators accepted:

  • eq or empty => equal
  • gt => greater than
  • ge => greater or equal
  • lt => less than
  • le => less or equal
  • ne => not equal
  • ct => contains
  • nct => not contains
  • in => inside array
  • nin => not inside array
limitRecord
integer
default:20

Max number of records to return for the query. Use 0 or negative value to return all records.

Example:

0

fromRecord
integer
default:0

The number of records to skip before starting to collect the result set.

Example:

251

sortBy
string

The field name to use for sorting results. Use desc(field_name) to sort descending by field_name, and use asc(field_name) to sort ascending by field_name.

Example:

"desc(field_name)"

Response

200
application/json
Success

Response payload for queries related to transactions

Summary
object
Records
object[] | null