Reconciliation

POST/v3/payment/reconciliation

What is this?

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

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[String]

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

Example: ["BOOST"]

regionArray[String]

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

Example: ["MALAYSIA"]

cursorString

Pagination cursor from previous response

Example Request

JSON

1{
2  "transactionType": "PAYMENT",
3  "date": "2021-07-28",
4  "method": ["BOOST"],
5  "region": ["MALAYSIA"],
6  "cursor": ""
7}

Response Parameters

itemsArray

List of reconciled transaction records

meta.cursorString

Pagination cursor for next page

codeString

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

error.codeString

Error code if the request failed.

error.messageString

Error message if the request failed.

error.debugString

Debug message (sandbox only).

Transaction record (items[*]):

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