入门通用约定
通用约定
数据格式、请求重试、错误和限额的规则适用于所有接口。
更新于 2026年10月8日 · 阅读约需 1 分钟
数据格式
- 金额保留两位小数的 USDT 字符串（1 USDT = 1 $），字段名以
_usdt结尾；API 中没有卢布"19.00" - 时间带
Z的 UTC 时间，字段名以_at结尾2026-09-24T10:14:03Z - 编号字段按所指对象命名：
order_id、product_id、operation_id、event_idevt_1042 - 列表按 UTC 单日返回：
?date=YYYY-MM-DD，不带参数即为当天；最新的在前?date=2026-09-28 - 状态单个单词：
completed、waiting、processing、failed、canceled、refundedwaiting
请求重试
API 没有幂等键：重试是否安全，由订单状态保证。
场景响应处理方法
下单：未收到响应无不要盲目重试，先调用
GET /v1/orders（UTC 当天；临近午夜时还要查前一天）；确认订单不存在后，才重新下单客户信息提交了两次200安全：同一次尝试中不会再次发送给服务方；请查看响应中的
status取消请求发送了两次409
50004 order_already_closed，款项只退回一次生成新签名密钥：未收到响应无直接重试：旧签名密钥在 24 小时内仍会继续签名
错误与限额
- 统一错误格式所有错误都以
{"error": {…}}返回，包含字段code、name、message、details和request_id。请根据五位数字code做分支判断；message面向人阅读，内容可能变化。字段说明见「错误码」一节。 - request_id每个错误响应中都有；联系客服时请提供。
- 限额通过鉴权后的每个响应都带有
X-RateLimit-Limit、X-RateLimit-Remaining和X-RateLimit-Reset响应头；429响应带有Retry-After。
本页内容是否有帮助？
发现错误？在 Telegram 联系我们