List Transactions
The purpose of transaction API is to provide users with an ability to access the transaction related reports and merchant reports via API.
Get Transactions
GET https://<Platform-host>/api/merchant/:merchant_id/transaction
Path Parameters
merchant_id*
Merchant ID
Query Parameters
page
string
Page number
date[from]
string
Unix epoch
date[to]
string
Unix epoch
method
string
Credit Card, AHC
amount[from]
string
From Amount
amount[to]
string
To Amount
status[n]
string
The array of statuses. Accepted values are succeeded, failed, refunded, partialRefund, pending, canceled
n=0, 1, 2... Example query string for multiple statuses
statuses[0]=partialRefund&statuses[1]=refunded&statuses[2]=pending
batch_id
string
Batch ID generated when transaction is settled
subscriptionId
string
Subscription ID
paymentLinkId
string
Payment Link ID
onlyDisputes
boolean
Indicates to filter only disputes
data
array
List of transactions
data[i].id
string
Platform system ID for the sale request
Required
data[i].transactionId
string
Unique transaction ID
Required
data[i].is_offline
boolean
Indicates whether the transaction is offline type.
Required
data[i].currency
string
Currency of the transaction
Required
data[i].internalTransactionID
string
Internal transaction ID provided
Optional
data[i].amount
string
Transaction dollar value
Required
data[i].gratuity
string
The final gratuity amount, included in the transaction, associated with the purchase
Optional
data[i].data.last_4
string
Last 4 digits of credit card or bank account
Required
data[i].data.bank_account_id
string
Platform bank account ID associated with this transaction if `payment_method` is ACH
Optional
data[i].data.card_type
string
Credit card type used for the transaction if `payment_method` is Credit Card
Optional
data[i].data.card_id
string
Platform card id associated with this transaction if `payment_method` is Credit Card
Optional
data[i].host_report
Object
Refer to Credit Card Sale (SaleResponse) or ACH Sale (AchResponse) object definitions
Required
data[i].payment_method
string
Transaction payment method. Possible values `Credit Card` | `ACH` | `Offline - <method>`
Required
data[i].type
string
Transaction type Possible values `payment` | `refund`
Required
data[i].status
string
Platform transaction status
Possible values succeeded | failed | pending | cancelled | pending_3dsauth
Required
data[i].created_at
string
Timestamp when the transaction was created
Required
data[i].settled
boolean
Indicates whether this transaction has been settled or not
Required
data[i].device
object
Device Object. This would exist for device based transactions
Optional
data[i].device.id
string
Device ID
data[i].device.type
string
Device Type
data[i].device.name
string
Device Name
data[i].device.model
string
Device Model
data[i].device.serial_number
string
Device Serial Number
data[i].device.manufacturer
string
Device manufacturer
data[i].device.sdk_version
string
Device SDK Version
data[i].device.app_version
string
Device App Version
data[i].device.os
string
Device operating system
data[i].device.os_version
string
Device OS version
meta.total
integer
Total transactions in this response
Required
meta.current_page
integer
Current page
Required
meta.total_pages
integer
Total pages available
Required
{
"data": [
{
"batch_id": null,
"merchant_id": "1e4e6029-2cc9-4b2c-87c1-7a4b2af6d6c6",
"id": "20655494-8713-47d9-9553-ec2acd959a2e",
"transactionId": "b48cf399-9e32-4733-9145-c586e5cf3a74",
"dispute_status": "AWAITING_CHARGEBACK_DETAILS",
"is_offline": false,
"currency": "USD",
"requested_currency": "USD",
"amount": "110.00",
"gratuity":"10.00",
"requested_amount": "110.00",
"currency_conversion_rate": null,
"fee_amount": null,
"net_amount": "110.00",
"data": {
"last_4": "1111",
"card_type": "visa",
"card_id": "d49d99e6-9b79-4f54-8284-d8f8054574c9",
"sales_tax": "10.00",
"order_number": "Order124",
"first_name": "card holder",
"last_name": "name",
"customer_name": "John Doe",
"accounting_data": {
"salesTax": "10.00",
"orderNumber": "Order124"
},
"ip_address": "10.10.10.10"
},
"card_type": "visa",
"last_4": "1111",
"host_report": {
"status": "PASS",
"responseCode": "A0000",
"responseMessage": "Success",
"authCode": "594450",
"hostResponseCode": "00",
"hostReferenceNumber": "695565385087",
"taskID": "88208569",
"transactionID": "35265177",
"transactionTimestamp": "2025-04-02T19:15:20",
"transactionAmount": "110.00",
"processedAmount": "110.00",
"totalAmount": "110.00",
"addressVerificationCode": "X",
"cardHolderVerificationCode": "N",
"cardType": "visa",
"maskedCardNumber": "1111",
"customerReceipt": " Sandbox US Merchant \\n 200 Epcot Center Dr \\n Orlando, FL 32836 \\n 800-490-8514 \\n \\n \\n 2025-04-02 07:15 PM \\n CREDIT - SALE \\n Entry Mode : KEYED \\n Transaction ID: 35265177 \\n Invoice Number: Order124 \\nDescription: Payment for the service\\n s \\n SUBTOTAL: USD $100.00 \\n SALES TAX: USD $10.00 \\n TOTAL: USD $110.00 \\n \\n \\n NO SIGNATURE REQUIRED \\n APPROVED \\n \\n \\n \\n \\n \\n \\n \\n \\n \\n \\n Customer Copy \\n",
"merchantReceipt": " Sandbox US Merchant \\n 200 Epcot Center Dr \\n Orlando, FL 32836 \\n 800-490-8514 \\n \\n \\n 2025-04-02 07:15 PM \\n CREDIT - SALE \\n Entry Mode : KEYED \\n Transaction ID: 35265177 \\n Invoice Number: Order124 \\nDescription: Payment for the service\\n s \\n SUBTOTAL: USD $100.00 \\n SALES TAX: USD $10.00 \\n TOTAL: USD $110.00 \\n \\n \\n X_______________________ \\nI AGREE TO PAY ABOVE TOTAL AMOUNT IN\\n ACCORDANCE WITH CARD ISSUER's AGREE\\nMENT (MERCHANT AGREEMENT IF CREDIT V\\n OUCHER) \\n KEEP COPY FOR YOUR RECORDS \\n \\n \\n \\n APPROVED \\n \\n \\n \\n \\n \\n \\n \\n \\n \\n \\n Merchant Copy \\n",
"partialPayment": false,
"providedSalesTax": true
},
"kount_score": null,
"payment_method": "Credit Card",
"type": "payment",
"fee_type": null,
"presettlement_fee": null,
"status": "succeeded",
"description": "Payment for the services",
"updated_at": "2025-04-02T19:15:20.839Z",
"created_at": "2025-04-02T19:15:20.839Z",
"external_id": "35265177",
"internalTransactionID": "987654321",
"customer_name": "card holder name",
"customer_main_name": "John Doe",
"refund_type": null,
"dispute_data": null,
"gateway": "sandbox",
"gateway_id": null,
"used_threeds": false,
"settled": false,
"device":{
"id":"a42627a7-1368-4f2d-b22e-f78f2d216d3e",
"type":"pax",
"name":"Shaun's Mobile",
"model":"S24",
"serial_number":"1234de30e5fcfcbb7819c18e264ce4000dd0",
"sdk_version":"1.0.0",
"manufacturer": "Pax",
"app_version": "1.0.0 (1)",
"os": "android",
"os_version": "14"
}
}
],
"meta": {
"total": 1,
"current_page": 1,
"total_pages": 1
}
}Last updated