跳转到主要内容
Stablecoin Account API 发布方声明 沙盒环境使用与生产完全相同的 API,只是运行在测试余额之上,你可以在不动用真实资金的情况下完成各流程的集成与验证。

沙盒 Base URL

所有接口路径与生产一致 —— 只有 Base URL 不同。使用沙盒凭证认证:通过 Access Token 接口获取 token,并放在 x-auth-token 请求头中发送。

测试内容

Webhook 测试

配置你的沙盒 webhook 端点,然后触发每种订单类型并确认你的处理程序:
  • 能接受充值提现换汇转账页面列出的每个事件。
  • event_id 去重 —— 同一事件可能被投递多次。
  • source_id 反查订单,而不是只信任报文内容。
  • 能处理乱序投递:success 事件可能先于迟到重发的 pending 事件到达。
  • 能容忍 data 中的未知字段,例如只在被标记的充值上出现的 need_travel_rule

切换到生产

  • 把 Base URL 换成 https://api.uqpay.com/api,并切换到生产凭证。
  • 在生产环境重新检查 List Supported Assets and Networks —— 沙盒与生产的可用性、最小金额和费用可能不同。
  • 重新配置生产 webhook 端点,并端到端验证每种类型至少一个事件。