Fiat reconciliation download
About 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
| Country | Code | Production |
|---|---|---|
| Philippines | ph | https://openapi.toppayment.com/ph/reconciliation/v1/download |
| Indonesia | id | https://openapi.toppayment.com/id/reconciliation/v1/download |
| Nigeria | ng | https://openapi.toppayment.com/ng/reconciliation/v1/download |
| India | in | https://openapi.toppayment.com/in/reconciliation/v1/download |
| Thailand | th | https://openapi.toppayment.com/th/reconciliation/v1/download |
| Vietnam | vn | https://openapi.toppayment.com/vn/reconciliation/v1/download |
| Peru | pe | https://openapi.toppayment.com/pe/reconciliation/v1/download |
| Brazil | br | https://openapi.toppayment.com/br/reconciliation/v1/download |
| Mexico | mx | https://openapi.toppayment.com/mx/reconciliation/v1/download |
| Colombia | co | https://openapi.toppayment.com/co/reconciliation/v1/download |
| Bolivia | bo | https://openapi.toppayment.com/bo/reconciliation/v1/download |
| Pakistan | pk | https://openapi.toppayment.com/pk/reconciliation/v1/download |
| Bangladesh | bd | https://openapi.toppayment.com/bd/reconciliation/v1/download |
| Turkey | tr | https://openapi.toppayment.com/tr/reconciliation/v1/download |
Headers
| Field | Required | Type | Description |
|---|---|---|---|
| Content-Type | M | String | Fixed value: application/json |
Body
| Field | Required | Type | Description |
|---|---|---|---|
| mchNo | M | String(32) | Merchant number |
| date | M | String(10) | Bill date, yyyy-MM-ddYesterday or earlier only. Today or a future date returns 1005 |
| timestamp | M | String(13) | 13-digit millisecond timestamp, within ±5 minutes |
| sign | M | String | See Signature Sign only date, mchNo, and timestamp |
Example
Content-Type: application/json
{
"mchNo": "{{mchNo}}",
"date": "2026-11-09",
"timestamp": "1749102949784",
"sign": "replace with the generated signature"
}
Response
| Field | Required | Type | Description |
|---|---|---|---|
| success | M | Boolean | Whether the call succeeded |
| code | M | String | 9999 on success. See Error codes |
| msg | O | String | Failure message. null on success |
| timeStamp | M | Number | Server time in milliseconds |
| data | M | Object | Present on success |
| date | M | String | Bill date |
| downloadUrl | M | String | Download 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
| Code | Meaning |
|---|---|
| 0001 | Invalid parameter, for example date is not yyyy-MM-dd, or the timestamp is outside the window |
| 0002 | Signature failed |
| 1001 | IP allowlist rejected. The egress IP is missing, or the list is empty |
| 1005 | Reconciliation file not found |
