Skip to main content

Fiat reconciliation download

TOPPAY TeamAbout 1 min

Request

Download the merchant fiat reconciliation file for a bill date. The file is the same one shown in the merchant console. The response is a time-limited download URL.

IP allowlist is mandatory

This API always checks the request IP allowlist. The pay-in / pay-out / order inquiry / balance checkboxes do not apply.

Add the caller's public egress IP to Request IP allowlist in the merchant console. An empty list, or an IP that is not on the list, returns 1001.

Path

POST. There is no sandbox URL.

Production: https://openapi.toppayment.com/{country}/reconciliation/v1/download

CountryCodeProduction
Philippinesphhttps://openapi.toppayment.com/ph/reconciliation/v1/download
Indonesiaidhttps://openapi.toppayment.com/id/reconciliation/v1/download
Nigerianghttps://openapi.toppayment.com/ng/reconciliation/v1/download
Indiainhttps://openapi.toppayment.com/in/reconciliation/v1/download
Thailandthhttps://openapi.toppayment.com/th/reconciliation/v1/download
Vietnamvnhttps://openapi.toppayment.com/vn/reconciliation/v1/download
Perupehttps://openapi.toppayment.com/pe/reconciliation/v1/download
Brazilbrhttps://openapi.toppayment.com/br/reconciliation/v1/download
Mexicomxhttps://openapi.toppayment.com/mx/reconciliation/v1/download
Colombiacohttps://openapi.toppayment.com/co/reconciliation/v1/download
Boliviabohttps://openapi.toppayment.com/bo/reconciliation/v1/download
Pakistanpkhttps://openapi.toppayment.com/pk/reconciliation/v1/download
Bangladeshbdhttps://openapi.toppayment.com/bd/reconciliation/v1/download
Turkeytrhttps://openapi.toppayment.com/tr/reconciliation/v1/download

Headers

FieldRequiredTypeDescription
Content-TypeMStringFixed value: application/json

Body

FieldRequiredTypeDescription
mchNoMString(32)Merchant number
dateMString(10)Bill date, yyyy-MM-dd
Yesterday or earlier only. Today or a future date returns 1005
timestampMString(13)13-digit millisecond timestamp, within ±5 minutes
signMStringSee Signature
Sign only date, mchNo, and timestamp

Example

Content-Type: application/json

Response

FieldRequiredTypeDescription
successMBooleanWhether the call succeeded
codeMString9999 on success. See Error codes
msgOStringFailure message. null on success
timeStampMNumberServer time in milliseconds
dataMObjectPresent on success
dateMStringBill date
downloadUrlMStringDownload URL, valid for 1 hour
{
    "success": true,
    "code": "9999",
    "msg": null,
    "timeStamp": 1767873172906,
    "data": {
        "date": "2026-11-09",
        "downloadUrl": "https://storage.googleapis.com/example/assetRecord/bill.csv?X-Goog-Expires=3600"
    }
}

Common errors

CodeMeaning
0001Invalid parameter, for example date is not yyyy-MM-dd, or the timestamp is outside the window
0002Signature failed
1001IP allowlist rejected. The egress IP is missing, or the list is empty
1005Reconciliation file not found