加密货币支付网关是什么?从下单到到账全流程
加密货币支付网关负责把一笔链上转账变成一张已支付订单。本文讲清每一步在做什么、托管与非托管的区别,以及选网关前该问的问题。
做线上生意,迟早会有客户问:「能用 USDT 付吗?」这时你会接触到加密货币支付网关。它夹在你的收银页和区块链中间,把陌生钱包打来的一笔转账变成你系统里一张「已支付」的订单。下面讲清楚它每一步在做什么、容易出问题的地方在哪,以及选网关时该看什么。
加密货币支付网关到底做了什么
刷卡支付时,支付机构帮你处理所有麻烦事,最后给你一个「支付成功」的通知。加密货币不一样,它是「推」的模式:客户把钱转到一个地址,如果没人盯着链上,你根本不知道钱到了没有。网关的工作就是盯链,再把周边的事都处理好。
一笔典型的 USDT 收款会经过六个环节:
- 创建订单(Invoice):你的服务器告诉网关「订单 1042,25 USDT」,网关生成一条支付记录,带金额、币种和过期时间。
- 分配地址:网关决定客户应该把钱打到哪里,在收银页上展示二维码、地址和金额。
- 检测到账:持续扫描链上转入这个地址的交易。
- 等待确认:等交易真正「落定」,不可能再被回滚。
- 通知商户:一般通过 Webhook 回调通知你的服务器,你再去发货。
- 结算:钱最终到你手里,要么直接进你自己的钱包,要么进网关里的余额,之后再提现。
对商户来说,接入通常就是调一个接口。以 TillCrypto 为例,创建一笔收款大概是这样,其他网关也差不多:
curl https://api.tillcrypto.com/v1/payments \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"amount": "25.00",
"currency": "USDT-TRC20",
"order_id": "1042",
"success_url": "https://yourshop.com/thanks",
"cancel_url": "https://yourshop.com/cart"
}'返回结果里有 id、状态 pending 和 checkout_url。把客户跳转到这个链接,后面第 2 到第 6 步都由网关负责。从加按钮到标记订单已支付的完整步骤,可以看网站如何接入 USDT 收款。
网关怎么知道这笔钱是哪个订单的
很多人会低估这个问题。链上转账本身不带订单号,大多数钱包也不支持填备注,就算支持,客户也未必会填。所以网关只能靠「地址」和「金额」来判断一笔钱属于哪个订单。
常见做法有两种:
| 一单一地址 | 地址池 + 精确金额 | |
|---|---|---|
| 匹配方式 | 每个订单分配一个新地址,打进来的钱就归这个订单 | 订单分散到一组地址上,按「地址 + 精确金额」匹配;只有地址和金额都撞上时才微调金额 |
| 优点 | 匹配简单,金额不对也能明确对应到某一单 | 需要管理、充 gas、归集的地址少很多 |
| 缺点 | 每个地址以后转出都要手续费,单量越大成本越高 | 客户必须按页面金额精确支付,少付或凑整都无法自动匹配 |
TillCrypto 用的是第二种的变体:一组收款地址轮流分配,按「地址 + 精确金额」匹配。同样是 100.00 USDT,第一笔还没付完时来了第二笔,第二笔一般会分到另一个地址;只有所有地址上都已经有一笔 100.00 待支付时,金额才会上调为 100.01。不管哪种情况,客户都得按页面上的金额精确支付,「大概打 100 过去」是不行的。
检测和确认:什么时候才算真的到账
「看到转账」和「可以相信这笔转账」是两回事。交易可能广播了却一直没被打包,也可能被打包进一个后来被网络丢弃的区块。靠谱的网关只在交易最终确认后,才把订单标为已支付。
确认要多久取决于哪条链。波场(TRON)大约每 3 秒出一个块,当 27 个超级代表中至少 19 个在它之后出过块,这个块就「固化」不可逆了,通常一分钟左右。以太坊在权益证明下大约需要两个 epoch(每个约 6.4 分钟,合计约 13 分钟)才达到最终性。这也是 TRC20 USDT 在小额 U 收款里特别常见的原因之一。三条链在手续费、到账速度上的其他差别,可以看USDT 的 TRC20 和 ERC20 区别(附 BEP20 对比)。
还有一个容易被忽视的安全点:任何人都能发一个名字叫「USDT」的代币。名字不说明任何问题,真正要看的是代币合约地址。Tether 官方公布了它直接发行的各条链上的合约地址(包括波场和以太坊);BNB Chain 上的 USDT 是币安桥接的代币,要以网关文档里写的合约地址为准。只看代币名、不校验合约的网关,可能会被一文不值的假币骗过去。
Webhook 回调:你的系统怎么得知已付款
支付确认后,网关会向你的服务器发一个 HTTP 请求,你的发货逻辑应该由它来触发。一个靠谱的回调机制应该具备:
- 有签名:请求带 HMAC 签名,密钥只有你和网关知道,别人伪造不了「已支付」事件。
- 带时间戳:签名覆盖时间戳,被截获的旧请求过一段时间再重放,可以直接拒绝。
- 会重试:你的服务器宕机或返回错误时,网关会按间隔多次重试,而不是发一次就算了。
- 有事件 ID:每个事件有唯一 ID,重复收到可以安全忽略。
- 能手动重发:你修好自己的 bug 后,可以在后台重新推送。
签名校验(用原始请求体、常量时间比较、时间戳容差)代码不长,但很容易写出隐蔽的漏洞。具体写法见如何校验加密货币支付回调。
托管和非托管支付网关的区别
这是不同网关之间最根本的区别,也是选之前最该先弄清楚的一点。
托管型网关把款收进它自己控制的地址,你的钱变成它账本里的一笔余额,需要时再申请提现到链上。非托管型网关让款直接进你控制的地址(通常由你提供的公钥派生),它只负责盯链和通知。
| 托管型 | 非托管型 | |
|---|---|---|
| 私钥在谁手里 | 网关运营方 | 你自己 |
| 上手难度 | 注册拿到 API Key 就能用 | 还得自己搭建并保管好钱包 |
| 资金怎么拿出来 | 申请提现,由运营方打款 | 本来就在你钱包里 |
| 金额错误、退款 | 运营方可以人工核对、调整余额 | 你自己从钱包里处理 |
| 主要风险 | 依赖运营方保管资金并正常打款 | 私钥安全和 gas 都得你自己负责 |
两者没有绝对的好坏。托管型用起来简单,特别适合不想管私钥、也不想随时备着 gas 的商户;非托管型没有对手方风险,但运维工作全落在你身上。另外要看清所谓「非托管」的实际情况:如果你的私钥是在网关服务器上生成的,那就谈不上非托管。
先说明一下我们自己的情况:TillCrypto 是托管型。款项进入平台管理的地址,记入你的商户余额;你在后台或通过 API 申请提现,经审核后链上打款,并记录交易哈希。用任何托管服务,都建议定期提现,不要把大额余额长期放在平台上。
选择 USDT 收款网关时要看什么
各家的功能介绍页写得都差不多,真正的差别要靠下面这些问题问出来:
| 方面 | 该问什么 | 危险信号 |
|---|---|---|
| 费用 | 手续费比例、提现费、月费,按你的单量算总账 | 注册后才能看到收费 |
| 网络 | 哪些链和币种现在就能用,而不是「即将上线」 | 只放一排模糊的图标 |
| Webhook | 有签名吗?会重试吗?能手动重发吗?有测试事件吗? | 回调不签名、只发一次 |
| 测试模式 | 不花真钱能模拟一笔支付成功吗? | 只能用真钱测试 |
| 异常情况 | 少付、多付、币种不对、过期后才付怎么处理? | 「这种情况不会发生」 |
| 提现 | 多久能提、最低额度、网络费、有没有链上凭证 | 审核时间说不清,没有交易哈希 |
表里最值得花时间的是异常情况。客户一定会晚付、重复付、转错币,或者少转几分钱,网关怎么处理这些,直接决定你要回多少客服消息。问的时候要问到具体:收银页过期十分钟后才到的款,还认不认?宽限多久?币种或金额不对的转账,是记下来等人工核对,还是直接被忽略?每种情况的细节可以看加密货币收款常见异常处理。
费用一定要算总账。0% 收款手续费加固定提现费,和 1% 手续费但提现免费,差别可能很大。每月收 2,000 USDT、只提现一次的话,1% 是 20 USDT,而提现费只有一笔 2 USDT;每月只收 100 USDT 却每周提一次,情况就反过来了:四次提现费共 8 USDT,按 1% 算只要 1 USDT。
正式接入前,花一两个小时测一遍
一家网关好不好用,一两个小时基本就能摸清:
- 用测试模式通过 API 创建一笔收款,并模拟支付成功。
- 把 Webhook 指向你的服务器,校验签名,记录事件 ID。
- 把接口停掉,再触发一个事件,看会不会收到重试。
- 用手机打开收银页,看客户能不能顺利扫码、复制地址并付款。
- 切到正式模式,真实付一笔小额(金额要大于提现手续费,比如 10 USDT),然后申请提现,核对手续费和链上交易。
这五步都顺利的话,问题基本都能在客户遇到之前被你发现。