Skip to main content

Crypto reconciliation download

TOPPAY TeamAbout 1 min

Overview

Download the merchant crypto reconciliation file for a bill date and currency. Each currency has its own daily file. See Crypto overview for headers and signing.

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.

EnvironmentURL
Productionhttps://openapi.toppayment.com/crypto/reconciliation/v1/download

global-digit-openapi.toppayment.com still works. The path is the same.

Headers

FieldRequiredTypeDescription
Content-TypeMStringFixed value: application/json
NonceMString(16-64)Anti-replay value. Unique for 10 minutes. Not part of the signature

Body

FieldRequiredTypeDescription
mchNoMString(32)Merchant number
dateMString(10)Bill date, yyyy-MM-dd
Yesterday or earlier only. Today or a future date returns 1005
currencyOString(16)Currency, such as USDT, USDC, ETH, BTC
Defaults to USDT. Values are matched in uppercase
timestampMString(13)13-digit millisecond timestamp, within ±5 minutes
signMStringSee Signature
tenantCodeOString(32)Sub-tenant code. Omit it to use the default tenant

If that currency had no balance movement on the bill date, there is no file and the API returns 1005.

Example

Content-Type: application/json
Nonce: a91e60c3b7d248f5c0a2

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
currencyMStringCurrency actually queried. USDT when omitted
downloadUrlMStringDownload URL, valid for 1 hour
{
    "success": true,
    "code": "9999",
    "msg": null,
    "timeStamp": 1767873172906,
    "data": {
        "date": "2026-11-10",
        "currency": "USDT",
        "downloadUrl": "https://storage.googleapis.com/example/assetRecord/bill.csv?X-Goog-Expires=3600"
    }
}

Common errors

CodeMeaning
0001Invalid parameter, timestamp, or Nonce
0002Signature failed
1001IP allowlist rejected
1005No reconciliation file for that date and currency