数字商品 USDT 收款:自动发货与订单设计指南

会员、授权码、游戏道具、下载资源天生适合 U 收款。本文讲清楚订单流程怎么设计、怎么用回调自动发货,以及续费、客服和对账怎么做才省心。

TTillCrypto 团队7 分钟阅读

会员订阅、软件授权码、游戏道具、下载资源,这类数字商品天生适合 USDT 收款:没有物流,钱一到账就能自动发货。真正容易出问题的地方很少在链上,而是在三件事上:订单流程怎么设计、重复回调怎么处理、客服工单怎么回。

数字商品 USDT 收款:先把订单状态设计清楚

不少收款 bug,根子都在订单状态没想清楚。动手写代码前,先把状态列出来:

你系统里的订单状态 含义 用户看到什么
awaiting_payment 订单已创建,已生成付款链接 带二维码和倒计时的收银台
paid 已确认收到付款 「已收到付款,正在处理」
fulfilled 已发码、已开通、道具已到账 他买的东西
expired 超时且没有收到钱 「订单已过期,请重新下单」
needs_review 金额不对、发货失败等异常 「我们正在处理」

比较稳的流程是这样:

  1. 用户点「购买」,你先在自己的数据库里建单,价格在这一刻定死。
  2. 服务端带上你的订单号创建一笔收款,拿到收银台链接后把用户跳转过去。
  3. 用户付款,网关检测到已确认的转账,推送 payment.paid 回调。
  4. 回调处理程序把订单标记为已付款,并把发货任务放进队列。
  5. 发货任务执行完,订单变成 fulfilled。

以 TillCrypto 为例,第 2 步就是调用 POST /v1/payments,传 amount、currency、order_id、success_url 和 cancel_url。如果请求超时、服务端用同一个 order_id 重试,拿到的还是原来那笔收款,不会再建一笔;同一个 order_id 换了金额或币种再提交,会直接返回 409。也正因为这样,订单过期后应该让用户重新下单、生成新的订单号,沿用旧订单号只会拿回那笔已过期的收款。完整的接入步骤可以看 网站如何接入 USDT 收款。

用 payment.paid 回调自动发货

处理程序要短:验签、校验、改状态、扔进队列、返回 200。发邮件、调游戏服务器这类慢操作放到后台任务里做,免得邮件服务一卡,回调就超时重试。

javascript
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 收款的订阅,本质上是一期一期的账单,每期单独付。

比较靠谱的做法:

  1. 到期前几天,在你自己的系统里生成一张账单,比如 inv_8812-2026-12,邮件里放你自己的账单页链接,而不是收银台链接。收银台链接 60 分钟就过期,发邮件时就生成的话,用户点开多半已经失效。
  2. 用户点「付款」时再创建收款,每次尝试用一个新的 order_id,比如 inv_8812-2026-12-a1,并记下它属于哪张账单。这次的收银台过期了,用户再点一次就是 -a2。直接拿账单号当 order_id 的话,第二次点进去拿到的还是那笔已过期的收款。
  3. 收到 payment.paid 后,通过这次尝试找到对应账单。账单还没付,就在同一个事务里把它标为已付,并从「今天」和「当前到期日」里取较晚的那个往后延一个周期,提前续费的用户不会吃亏。
  4. 到期后留几天宽限期再降级,期间发一两封提醒。

幂等的关键在账单上,而不在 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 切出当月的数据。

参考资料

在你的网站上收 USDT

托管收银台、签名回调、测试模式。收款零手续费,没有月费。