快速开始

接入流程

1. 获取对接令牌

   • 登录后台 → 系统管理 → 基本设置 → API 设置
   • 记录 对接令牌（API Token）

2. 调用创建订单接口

   • 拼接参数 → 计算签名 → 发送 POST 请求
   • 拿到 payment_url（收银台链接）

3. 跳转到收银台

   • 把用户重定向到 payment_url
   • 用户扫码付款

4. 接收回调通知

   • 系统检测到链上到账后，会向你的 notify_url 推送支付结果
   • 验证签名 → 处理业务 → 返回 success

请求基础信息

项目	值
接口地址	https://usdt.686869.cloud
请求方式	POST
请求格式	JSON
响应格式	JSON
认证方式	MD5 签名

最小示例

请求：

POST https://usdt.686869.cloud/api/v1/order/create-transaction
Content-Type: application/json

{
  "order_id": "20250120001",
  "amount": 28.88,
  "fiat": "CNY",
  "trade_type": "usdt.trc20",
  "notify_url": "https://your.site/notify",
  "redirect_url": "https://your.site/success",
  "signature": "计算出来的签名"
}

响应：

{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "b3d2477c-d945-41da-96b7-f925bbd1b415",
    "order_id": "20250120001",
    "amount": "28.88",
    "actual_amount": "4.25",
    "token": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
    "status": 1,
    "payment_url": "https://usdt.686869.cloud/pay/checkout-counter/b3d2477c..."
  }
}

拿到 payment_url 后，把用户重定向过去即可。

下一步

• 签名算法 — 了解如何计算 signature
• 回调通知 — 处理支付结果
• 订单模式 — 普通模式 vs 独占模式