数字商品 USDT 收款:自动发货与订单设计指南
会员、授权码、游戏道具、下载资源天生适合 U 收款。本文讲清楚订单流程怎么设计、怎么用回调自动发货,以及续费、客服和对账怎么做才省心。
会员订阅、软件授权码、游戏道具、下载资源,这类数字商品天生适合 USDT 收款:没有物流,钱一到账就能自动发货。真正容易出问题的地方很少在链上,而是在三件事上:订单流程怎么设计、重复回调怎么处理、客服工单怎么回。
数字商品 USDT 收款:先把订单状态设计清楚
不少收款 bug,根子都在订单状态没想清楚。动手写代码前,先把状态列出来:
| 你系统里的订单状态 | 含义 | 用户看到什么 |
|---|---|---|
awaiting_payment |
订单已创建,已生成付款链接 | 带二维码和倒计时的收银台 |
paid |
已确认收到付款 | 「已收到付款,正在处理」 |
fulfilled |
已发码、已开通、道具已到账 | 他买的东西 |
expired |
超时且没有收到钱 | 「订单已过期,请重新下单」 |
needs_review |
金额不对、发货失败等异常 | 「我们正在处理」 |
比较稳的流程是这样:
- 用户点「购买」,你先在自己的数据库里建单,价格在这一刻定死。
- 服务端带上你的订单号创建一笔收款,拿到收银台链接后把用户跳转过去。
- 用户付款,网关检测到已确认的转账,推送
payment.paid回调。 - 回调处理程序把订单标记为已付款,并把发货任务放进队列。
- 发货任务执行完,订单变成
fulfilled。
以 TillCrypto 为例,第 2 步就是调用 POST /v1/payments,传 amount、currency、order_id、success_url 和 cancel_url。如果请求超时、服务端用同一个 order_id 重试,拿到的还是原来那笔收款,不会再建一笔;同一个 order_id 换了金额或币种再提交,会直接返回 409。也正因为这样,订单过期后应该让用户重新下单、生成新的订单号,沿用旧订单号只会拿回那笔已过期的收款。完整的接入步骤可以看 网站如何接入 USDT 收款。
用 payment.paid 回调自动发货
处理程序要短:验签、校验、改状态、扔进队列、返回 200。发邮件、调游戏服务器这类慢操作放到后台任务里做,免得邮件服务一卡,回调就超时重试。
app.post('/webhooks/tillcrypto', express.raw({ type: 'application/json' }), async (req, res) => {
// 第一件事:用原始请求体校验 X-TillCrypto-Signature
if (!verifySignature(req.get('X-TillCrypto-Signature'), req.body, process.env.TILL_WEBHOOK_SECRET)) {
return res.status(400).send('bad signature');
}
const event = JSON.parse(req.body.toString('utf8'));
if (event.type !== 'payment.paid') return res.sendStatus(200);
if (event.livemode !== IS_PRODUCTION) return res.sendStatus(200);
const p = event.data;
// 条件更新:重复送达的回调只有一次能更新成功
const result = await db.query(
`UPDATE orders SET status = 'paid', payment_id = $1, txid = $2, paid_at = now()
WHERE id = $3 AND status IN ('awaiting_payment', 'expired')
AND amount = $4 AND currency = $5`,
[p.id, p.txid, p.order_id, p.amount, p.currency]
);
if (result.rowCount === 1) {
await queue.add('fulfill', { orderId: p.order_id });
} else {
// 要么是重复回调,要么是对不上的钱,后者必须有人知道
const order = p.order_id ? await db.getOrder(p.order_id) : null;
const alreadyHandled = order && ['paid', 'fulfilled', 'needs_review'].includes(order.status);
if (!alreadyHandled) {
if (order) await db.markNeedsReview(order.id, p.id);
await alertSupport('payment.paid 没有匹配到订单', p);
}
}
res.sendStatus(200);
});这段代码里有几个容易忽略的细节:
- 先验签,而且用原始 body。 先把 JSON 解析了再验 HMAC,字节可能已经变了,验签会失败,甚至被悄悄跳过。签名格式和时间戳校验见 如何验证加密支付回调。
- 测试事件进不了生产。 测试模式下可以模拟付款成功,检查
livemode能保证测试事件永远不会给真实用户发码。 - 付了钱的回调不能悄悄吞掉。 返回 200 之后就不会再重试了。如果条件更新一行都没改到、订单又不是已处理状态,就得转人工并报警。金额对不上、后台生成的付款链接没有
order_id,都会走到这里,而用户的钱是真付了。 - 按接口的原样存值。 回调里的
currency是接口值(USDT-TRC20或TRX),amount是"100.00"这样的小数字符串。你表里要是只存了USDT,比对永远不会成功。 - 比对
amount,别比对链上实际金额。 两个人同一时间付同样的金额时,其中一个可能被要求付 100.01,用来区分两笔转账。订单价格仍然是 100.00。 expired也可以变成paid。 收银台关闭后 30 分钟内到账的付款仍然会入账。如果你用自己的 60 分钟定时器把订单标成过期,之后再收到payment.paid是正常的。payment.expired要等这段宽限期过了才会发,发了就是最终状态,后面不会再有payment.paid,所以拿它来触发过期最省心。
发货逻辑必须幂等
回调的规则是「至少送达一次」,不是「恰好一次」。你的服务响应太慢或者返回了错误,就会自动重试(1 分钟、5 分钟、15 分钟、1 小时、6 小时、24 小时),失败的事件还可以在后台手动重发。最麻烦的是这种情况:你其实已经处理完了,只是响应没能及时回去,下一次投递看起来就像一条全新的事件。
上面那条带条件的 UPDATE 是第一道保险:只有一个请求能把订单从 awaiting_payment 改走。第二道保险在发货任务里,因为任务本身也会重试。给每次发货找一个天然唯一的键,一般就是你的订单号:
| 商品类型 | 发货动作 | 幂等键 |
|---|---|---|
| SaaS 会员 | 延长账号的 plan_active_until |
plan_grants 表上 UNIQUE(order_id) |
| 软件授权码 | 从码池里分配一个码 | 授权码表上 UNIQUE(order_id) |
| 游戏道具 / 点数 | 调游戏服的发放接口 | 把订单号作为发放 ID 传过去(接口支持的话) |
| 下载资源 | 发一个带签名、会过期的下载链接 | 以购买记录为准,链接可以随时重新生成 |
分配授权码时,先查这个订单是不是已经分到过码,有就直接复用;没有再用一条语句领取一个空闲的码。两个任务恰好同时执行的极端情况,交给唯一约束兜底。同一个码发两封邮件没关系,一个订单发出去两个码才是事故。
数字商品用 USDT 定价,还是按美元换算?
直接用 USDT 定价。 月费就是 29 USDT,用户就转 29 USDT。USDT 按 1:1 锚定美元,对大多数数字商品来说,这跟美元标价差不多,记账也简单。
按美元标价,下单时换算。 如果你同时收银行卡,想只维护一套价格;或者你收 TRX 这种价格一直在动的币,就适合这种做法。在创建收款时换算,把美元价格和币种金额都存到订单上,在 60 分钟的付款窗口内把报价当成固定的,事后不要重算。
| USDT 定价 | 美元换算 | |
|---|---|---|
| 用户看到 | 整数价格 | 精确数字,如 31.42 TRX |
| 汇率风险 | USDT 很小 | 付款窗口内由你承担 |
| 适合 | 只收 U 的店 | 多种支付方式、收 TRX |
不管选哪种,用户都必须付精确金额。记得提醒直接从交易所提币付款的用户:有些交易所会从提币金额里扣手续费,到账就少了。
USDT 订阅续费:一张账单,可以付好几次
加密货币没有「扣款」这回事。你没法像绑卡那样每月 1 号从用户钱包里划钱。所以 U 收款的订阅,本质上是一期一期的账单,每期单独付。
比较靠谱的做法:
- 到期前几天,在你自己的系统里生成一张账单,比如
inv_8812-2026-12,邮件里放你自己的账单页链接,而不是收银台链接。收银台链接 60 分钟就过期,发邮件时就生成的话,用户点开多半已经失效。 - 用户点「付款」时再创建收款,每次尝试用一个新的
order_id,比如inv_8812-2026-12-a1,并记下它属于哪张账单。这次的收银台过期了,用户再点一次就是-a2。直接拿账单号当order_id的话,第二次点进去拿到的还是那笔已过期的收款。 - 收到
payment.paid后,通过这次尝试找到对应账单。账单还没付,就在同一个事务里把它标为已付,并从「今天」和「当前到期日」里取较晚的那个往后延一个周期,提前续费的用户不会吃亏。 - 到期后留几天宽限期再降级,期间发一两封提醒。
幂等的关键在账单上,而不在 order_id 上。「只有账单还没付才延期」这一条,既能挡住回调重试导致的重复延期,也能发现用户付了两次的情况(逾期到账也会入账,所以确实可能发生)。第二笔钱标出来,退款或者折成账户余额。
也可以考虑给 USDT 付款的用户一个打折的年付方案,一年只付一次。
常见客服问题和回复话术
工单大多就那几类,提前准备好回复,客服回得快,口径也统一。
「我付了钱但没收到货。」 先要订单号和交易哈希,查一下这笔收款。如果还是待支付,多半是转账还没确认。「您好,订单已经查到了。付款在链上确认后才会入账,一般几分钟内,入账后会自动发货。如果 30 分钟后还没收到,请回复交易哈希,我们人工核查。」
「我还在转账,倒计时就结束了。」 「没关系,倒计时结束后不久到账的付款仍然会匹配到您的订单,正常转出的话会自动处理。」
「我转错金额了。」 金额不对或币种不对的转账会记为未匹配,等待人工处理。「收到,麻烦把交易哈希发给我们,我们来处理。」然后再决定:照常发货、让用户新下一单补差价,或者退款。
「能退款吗?」 链上没有拒付,退款就是你自己再转一笔。「可以的,请提供一个和您付款时相同币种、相同网络的地址(比如 TRON 网络的 USDT,也就是 TRC20 地址),我们会退到这个地址。」别图省事直接退回付款来源地址:用户如果是从交易所提币付的,那个地址属于交易所,钱很可能到不了他账上。更多奇怪的情况,见 加密支付的各种边缘情况。
U 收款的对账与导出
只要一开始就把字段存全,U 收款对账其实很轻松。每笔已付款订单至少记录:
- 你的订单号和网关的收款 ID
- 币种和价格;如果做了换算,再加上当时的美元参考价
- 实际到账金额和交易哈希
- 付款时间(统一存 UTC)
TillCrypto 不收交易手续费,所以每笔收款的 net_amount 就是链上实际到账的金额,可能是 100.01 而不是标价 100.00,这也是为什么直接加总订单价格对不上。提现正好反过来:每笔 USDT 提现的 2 USDT 网络费从提现金额里扣,申请提现 500 USDT,到账 498 USDT,余额减少 500。提现一申请就会从余额里扣掉,被驳回的会退回余额。
所以对账公式是:已付收款的 net_amount 合计,减去提现金额合计,等于当前余额。USDT 和 TRX 余额是分开的,要按币种分别算(TRX 提现的网络费是 2 TRX)。导出时,GET /v1/payments 按时间倒序分页返回,也支持按 order_id 筛选。一页页往前翻,翻过月初为止,再按 created_at 切出当月的数据。