Appearance
订单模式
系统支持两种订单模式,通过创建订单时的 amount 参数决定。
普通模式
触发条件:amount > 0
特点:
- 地址 + 金额同时锁定
- 到账金额必须匹配订单金额(允许 ±匹配容差)
- 适用于商城购物、固定金额收款
示例:
json
{
"order_id": "20250120001",
"amount": 28.88,
"fiat": "CNY",
"trade_type": "usdt.trc20"
}用户需要精确转账换算后的 USDT 金额(actual_amount)。
独占模式
触发条件:amount = 0 或不传
特点:
- 仅锁定地址,金额不限
- 任意金额到账均触发回调
- 回调中的
amount和actual_amount以实际到账金额为准 - 适用于充值场景、钱包监控、不定额收款
示例:
json
{
"order_id": "20250120001",
"trade_type": "usdt.trc20",
"notify_url": "https://your.site/notify",
"redirect_url": "https://your.site/success"
}对比
| 项目 | 普通模式 | 独占模式 |
|---|---|---|
| 触发条件 | amount > 0 | amount = 0 或不传 |
| 地址分配 | 地址 + 金额锁定 | 仅锁地址 |
| 金额匹配 | 必须匹配订单金额 | 任意金额 |
| 典型场景 | 商城、固定金额 | 充值、监控、不定额 |
推荐使用
- 商城 / 订单支付 → 普通模式
- 账户充值 / 钱包监控 → 独占模式