Skip to main content

Reconciliation

Retrieve a list of settled transactions for a specific date, filtered by payment method and region. Use this for end-of-day reconciliation, financial reporting, or matching transactions against your own records.

When to Use

Use this endpoint when you:

  • Need to reconcile daily transactions with your bank statements
  • Want to generate settlement reports for accounting
  • Need to verify which transactions were settled on a given date

How to Use

Endpoint
POST/v3/payment/reconciliation

Step 1: Set the Transaction Date

Choose the date you want to reconcile. Use the format YYYY-MM-DD.

Step 2: Optionally Filter by Method and Region

Specify which payment methods (e.g., BOOST, TNG, ALIPAY) and regions to include. If omitted, all methods and regions are returned.

Step 3: Make the POST Request

Send the date and optional filters. Use the cursor field for pagination on subsequent requests.

Step 4: Review the Response

Each item in items represents a settled transaction. Use meta.cursor for pagination if results are truncated.


Request Parameters

transactionTypeSTRING

Type of transactions to retrieve (e.g., "PAYMENT")

dateSTRINGrequired

Transaction date in YYYY-MM-DD format

Example: "2021-07-28"

methodARRAY

Filter by payment methods (e.g., ["BOOST"])

Example: ["BOOST"]

regionARRAY

Filter by regions (e.g., ["MALAYSIA"])

Example: ["MALAYSIA"]

cursorSTRING

Pagination cursor from previous response

Response Parameters

itemsARRAY

List of reconciled transaction records

transactionAtSTRING

Transaction date time

merchantIdSTRING

Merchant ID

merchantNameSTRING

Merchant name

storeIdSTRING

Store ID

storeNameSTRING

Store name

regionSTRING

Transaction region

methodSTRING

Payment method

transactionTypeSTRING

Transaction type (PAYMENT or REFUND)

typeSTRING

Transaction type

transactionIdSTRING

Transaction ID

orderIdSTRING

Order ID

currencyTypeSTRING

Currency type

grossAmountSTRING

Gross transaction amount

mdrSTRING

MDR (merchant discount rate) amount

serviceFeeSTRING

Service fee amount

settlementAmountSTRING

Net settlement amount

metaOBJECT

Pagination metadata

cursorSTRING

Pagination cursor for next page

codeSTRING

"SUCCESS" if the request succeeded, otherwise an error code.

errorOBJECT

Error details

codeSTRING

Error code if the request failed.

messageSTRING

Error message if the request failed.

debugSTRING

Debug message (sandbox only).