数字货币对账单下载
大约 2 分钟
概述
按账单日和币种下载商户数字货币对账文件。每个币种单独一份日账单。公共请求头、签名规则见 数字货币接入总览。
强制 IP 白名单
本接口强制校验请求 IP 白名单,与是否勾选「代收 / 代付 / 订单查询 / 余额查询」无关。
请把调用方的出口公网 IP 配到商户后台「请求 IP 白名单」。名单为空,或出口 IP 不在名单中,返回 1001。
请求路径
POST。本接口没有沙箱地址。
| 环境 | 地址 |
|---|---|
| 生产 | https://openapi.toppayment.com/crypto/reconciliation/v1/download |
原数字货币域名 global-digit-openapi.toppayment.com 仍可用,路径不变。
请求头参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| Content-Type | M | String | 固定值:application/json |
| Nonce | M | String(16-64) | 防重放随机串,10 分钟内不可重复,不参与签名 |
请求体参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| mchNo | M | String(32) | 商户编号 |
| date | M | String(10) | 账单日,格式 yyyy-MM-dd只能查昨天及更早。当天、未来日期返回 1005 |
| currency | O | String(16) | 币种,如 USDT、USDC、ETH、BTC不传默认 USDT。传入后按大写匹配 |
| timestamp | M | String(13) | 请求时间戳(13 位毫秒),偏差须在 ±5 分钟内 |
| sign | M | String | 签名,见 签名规则 |
| tenantCode | O | String(32) | 子租户编码,不传使用默认租户 |
当天该币种没有资金变动时,没有对应账单,返回 1005。
请求示例
Content-Type: application/json
Nonce: a91e60c3b7d248f5c0a2
{
"mchNo": "{{mchNo}}",
"date": "2026-11-10",
"currency": "USDT",
"timestamp": "1749102949784",
"sign": "按签名规则生成后替换"
}
响应体参数
| 字段 | 必填 | 类型 | 描述 |
|---|---|---|---|
| success | M | Boolean | 是否成功 |
| code | M | String | 9999 成功;其他见 异常码 |
| msg | O | String | 失败原因,成功时为 null |
| timeStamp | M | Number | 服务器响应时间(毫秒) |
| data | M | Object | 成功时返回 |
| date | M | String | 账单日 |
| currency | M | String | 实际查询的币种。未传时为 USDT |
| downloadUrl | M | String | 对账文件下载地址,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 | 签名失败 |
| 1001 | IP 白名单未通过。出口 IP 未配置,或名单为空 |
| 1005 | 该账单日、该币种没有对账文件 |
