USDT / USDC 收款接口下单与查单调试

图文步骤

按步骤在自己的后台操作，点击图片可放大查看。

1. 1

   从开发者中心左侧接口调试 → 调试接口进入。会员充值优先选择创建独享钱包，完整步骤见独享钱包收款教程；以下按固定金额收款说明。页面标有 LIVE · 生产环境，创建会写入真实数据；初次检查可先查询自己已有的订单。

   

2. 2

   在官方工具页填写自己的 6 位商户 UID 和 mch_ 开头的 API Key。两者只保存在当前页面内存，刷新后需重新填写；不要把带密钥的界面或请求头截图发给 AI 或客服。

3. 3

   选择“创建收款订单”，核对币种、商户订单号、金额和 notifyUrl。金额按字符串传递，商户订单号用于关联自己系统的订单；notifyUrl 必须是 HTTPS。验证平台回调时可点击“使用调试地址”，随后到“接收回调”页面查看；正式业务填写自己部署的回调地址。

4. 4

   确认需要真实建单后才点击“创建线上收款订单”。工具会生成时间戳、随机 nonce 和签名，并展示“请求与响应”。核对 HTTP 状态、orderNo、merchantOrderNo、cashierUrl 和 status；得到收银台只表示建单成功，不表示已到账。

5. 5

   切到“订单状态查询”，填写平台返回的 orderNo：PI 前缀查询收款，PO 前缀查询代付，不要填自己的 merchantOrderNo。收款以 completed 判断成功；代付以 confirmed 判断成功、failed 判断失败。响应不明时先核对原订单，不换订单号重复创建。

6. 6

   对照请求头、签名原文、请求体和原始响应排错：20005 检查密钥；20011 检查签名 path、参数排序与 body；20012 校准时间；20016 重新生成 nonce；40105 检查有效期内同金额收款订单；51004 检查费用余额。记录 requestId，并将脱敏错误交给开发者或 AI 排查。页面 Node.js / PHP 代码可作为对照，凭据通过环境变量读取。