跳至主要內容

数字货币对账单下载

TOPPAY Team大约 2 分钟

概述

按账单日和币种下载商户数字货币对账文件。每个币种单独一份日账单。公共请求头、签名规则见 数字货币接入总览。

强制 IP 白名单

本接口强制校验请求 IP 白名单,与是否勾选「代收 / 代付 / 订单查询 / 余额查询」无关。

请把调用方的出口公网 IP 配到商户后台「请求 IP 白名单」。名单为空,或出口 IP 不在名单中,返回 1001。

请求路径

POST。本接口没有沙箱地址。

环境地址
生产https://openapi.toppayment.com/crypto/reconciliation/v1/download

原数字货币域名 global-digit-openapi.toppayment.com 仍可用,路径不变。

请求头参数

字段必填类型描述
Content-TypeMString固定值:application/json
NonceMString(16-64)防重放随机串,10 分钟内不可重复,不参与签名

请求体参数

字段必填类型描述
mchNoMString(32)商户编号
dateMString(10)账单日,格式 yyyy-MM-dd
只能查昨天及更早。当天、未来日期返回 1005
currencyOString(16)币种,如 USDT、USDC、ETH、BTC
不传默认 USDT。传入后按大写匹配
timestampMString(13)请求时间戳(13 位毫秒),偏差须在 ±5 分钟内
signMString签名,见 签名规则
tenantCodeOString(32)子租户编码,不传使用默认租户

当天该币种没有资金变动时,没有对应账单,返回 1005。

请求示例

Content-Type: application/json
Nonce: a91e60c3b7d248f5c0a2

响应体参数

字段必填类型描述
successMBoolean是否成功
codeMString9999 成功;其他见 异常码
msgOString失败原因,成功时为 null
timeStampMNumber服务器响应时间(毫秒)
dataMObject成功时返回
dateMString账单日
currencyMString实际查询的币种。未传时为 USDT
downloadUrlMString对账文件下载地址,1 小时内有效

响应示例

{
    "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"
    }
}

常见错误

异常码说明
0001参数、时间戳或 Nonce 不合法
0002签名失败
1001IP 白名单未通过。出口 IP 未配置,或名单为空
1005该账单日、该币种没有对账文件