USDC收款接口与支付接口接入：BEP20、Solana 场景与验收

USDC 收款适合已经使用 BSC 或 Solana 钱包的数字商品、订阅与会员业务。先了解付款方可用网络，再在 USDC 专题选择收款方式；币种名称相同，不代表可以跨网络付款。

选择网络与业务模式

当前支持 BSC-USDC（BEP20）与 SOL-USDC（SPL）。BSC 请求使用 chainCode=BSC，Solana 使用 chainCode=SOL。商户先配置匹配钱包，付款页面同时展示网络、地址和金额；不要把 TRON-USDC 或未来扩链写成已支持。

接口参数与接入步骤

固定金额购买使用 POST /openapi/payin/orders。持久化 merchantOrderNo 与返回的 orderNo、address、cashierUrl、expireAt，再让用户进入平台返回的收银台。长期余额充值可选择独享地址绑定，不必把每次充值都设计为临时购买订单。

以下为请求体演示，未发送请求，不含真实商户、密钥或交易。完整调用还需在服务端按文档填写 UID、API Key、时间戳、nonce 与签名。金额使用字符串；不要用前端浮点计算作为资金入账依据。

{
  "chainCode": "BSC",
  "tokenSymbol": "USDC",
  "merchantOrderNo": "DEMO_PRODUCT_001",
  "amount": "10.00",
  "notifyUrl": "https://merchant.example.com/payments/notify"
}

状态、回调与异常处理

收款等待与确认阶段不是业务成功；以 completed 为成功依据。回调暂时不可达时，用 GET /openapi/payin/orders/{orderNo} 查询补偿。少付、错币种、错网络与过期后到账需要核实原交易，不向付款方承诺自动跨链找回。

固定金额收款创建超时且没有拿到 orderNo 时，先在后台核实原业务单，不能假定 merchantOrderNo 提供自动幂等重试保证。已有 orderNo 时按平台单号查单；回调幂等和下单重试是两个不同问题。

验签使用创建原订单时的 API Key 和原始 rawBody，校验 HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) 与 x-callback-signature。验签后再核对身份、订单、币种、网络与金额，以数据库事务和唯一约束保证只处理一次。业务已可靠持久化后返回 HTTP 2xx；浏览器跳转或截图不能代替到账结果。

演示案例：从接口到业务完成

演示：数字商品价格 10.00 USDC，创建 BSC 订单并保存单号。用户按订单网络付款后，服务端验证 completed 回调，在同一事务里写支付记录并授予一次下载权限。重复通知返回成功但不重复授权；网络超时先查原单。此流程是演示设计，不是客户案例或真实交易记录。

上线前逐项验证

• 合法签名可通过，修改原始回调内容后验签失败。
• 相同通知重复投递只入账一次；处理中断后可恢复。
• 查询结果与回调、业务账目和链上交易能够对应。
• 错链、金额异常、过期或未知结果进入排查流程，不直接标记业务成功。

继续接入与技术资料

• 接口参数
• 请求签名
• 回调验签
• 套餐与网络费
• 相关教程
• USDT 收款接口
• USDC 收款接口
• 独享地址收款
• Node.js SDK
• PHP / Laravel SDK
• Solana: tokens and token accounts

这些资料解释底层标准和实现方法，不代表官方机构为 UUGate 背书。具体接入参数以 UUGate 当前文档为准。

下一步

• USDT 支付接口
• USDC 支付接口
• API文档