USDT入金接入流程:TRC20与ERC20收款、链上确认和余额记账
USDT入金,是用户向商户自己的区块链地址付款,再由商户系统给用户增加站内余额。稳付pay负责监控交易、核实确认条件并发送业务回调,资金直接进入商户钱包,不代收、不托管。接入时应把真实链上收款与站内余额分开记录,用可靠的订单关联和幂等记账连接两者。
文章目录
一、两条网络与商户自有钱包
| 本站支持的网络 | 资产形式 | 接入时核对 |
|---|---|---|
| Tron | USDT TRC20 | Tron网络、已核验USDT合约、商户收款地址。 |
| Ethereum | USDT ERC20 | Ethereum网络、已核验USDT合约、商户收款地址。 |
不能只看“USDT”名称或代币图标。Tether官方协议与合约列表可用于核对对应网络的资产;同名代币不自动等于受支持的USDT。确认完整地址,不仅比较末尾几位。
客户直接支付到商户控制的钱包。开通监控只需按要求提供收款资料,不向稳付pay交出私钥或助记词。站内USDT余额是商户业务账本,钱包余额是链上资产,两者不能混为一个账户。
二、先绑定用户订单,再确认识别策略
商户先保存用户ID、原充值订单号、所选网络、资产、接收地址、应付数量、有效期和入账规则。若站内使用积分或其他计价单位,还要保存本次换算、精度与赠送规则快照,不能在付款后随意更改。
一笔转账怎样对应原订单,须在开通时与技术团队确认;不能假设平台会每单分配新地址、要求备注memo或自动微调金额。同地址下多用户同时付同额时,仅凭金额和大致时间不够识别,应按确认过的方案核对,无法唯一归属则转人工。
展示给用户的网络、商户地址与应付数量必须来自后端已保存的订单。本文只用MERCHANT_WALLET_ADDRESS、ORDER_ID等占位符,不提供可直接转账的示例地址。
地址变更应保留版本和生效范围,旧订单仍按原配置核对。是否接受分笔付款、如何累计以及订单失效后的处理,也需事先约定,不能把几笔同金额转账自动凑给一个用户。
三、从链上付款到站内余额的六步流程
- 创建充值订单绑定用户与网络、资产、收款地址和应付数量。
- 用户核对并付款选择正确网络,向商户自己的地址发送USDT。
- 监控候选交易识别相关转账事件,保留交易及事件标识。
- 核实执行与确认核对实际收款,等待所选网络配置的确认条件。
- 商户认证回调按专门约定验证来源与内容,匹配原订单。
- 原子记账事件认领、充值流水与用户余额一起持久化。
四、看到转账不等于已满足确认条件
钱包显示“已发送”、拿到交易哈希、广播成功或监听到Transfer,都不能单独作为余额入账依据。要核对正确网络上的实际执行结果、已核验代币合约、实际接收地址和USDT数量,再判断确认条件是否满足。交易调用的目标合约与事件里的收款人也不能混淆。
TRON确认语义文档区分广播、执行回执和固化状态;进入固化链仍需检查执行是否成功。Ethereum的终结性说明也表明,进入区块与达到终结性是不同阶段。
具体确认条件按网络及接入配置确定,不统一写成固定秒数。节点索引延迟或查询暂时失败时保留原记录继续核实,不因此认定转账失败或要求用户再转一次。
五、USDT回调协议需单独确认
开通时由技术人员明确回调认证方式、字段定义、确认规则、重试安排、应答内容和主动核查途径。本站现有支付宝、微信代收文档不能直接当作USDT协议,不套用其中的MD5字段、通知次数、OK应答或状态枚举。
商户后端验证通知真实性后,核对原订单、网络、代币合约、接收地址、实际USDT数量、交易标识及确认情况。用户归属由已保存订单确定,不信任浏览器提交的“付款成功”或未经认证的通知。信息不足时先核查,不直接加余额。
通知已到达但数据库写入失败,应按约定处理失败和补偿;重复通知与主动核查的结果进入同一记账入口。保留认证与处理记录,公开日志不写密钥或钱包秘密。
六、按转账事件去重,并原子更新余额
一笔链上交易可能包含多个转账事件,只用交易哈希去重可能漏记或错认。可用“网络+txHash+logIndex或事件序号”设计内部唯一事件键;这里是业务标识示例,不是已公布的平台字段。索引口径需统一,保留对应区块及事件证据,确保同一收款事件不能给多个订单重复抵款。
Ethereum日志说明包含交易哈希、日志索引和因重组而移除的标记。遇到确认回退或事件变化,应停止自动处理并复核原记录,不能当成新转账再次加款。
原订单的可入账额度和状态也要锁定核对;重复付款、多付或分笔付款按约定规则处理,不能看到新事件就再按整单金额加款。
认证通知并验证已确认的收款事件
开启数据库事务
锁定原充值订单及用户账户
检查事件唯一键及其已关联订单
若本事件已为本订单入账:不再加款
若本事件已被其他订单认领:记录冲突,不重复抵款
否则:保存事件认领、唯一充值流水和余额更新
提交事务
按约定返回处理结果按已核验代币合约的decimals处理最小单位整数,用定点或精确十进制计算,不用float计算USDT数量。原始数量、换算结果和赠送额度分别保存;事务失败整体回滚,重复或并发处理依靠数据库唯一约束,不能只靠先查后写。
例如事件EVENT_A已经计入ORDER_A,再次收到通知或核查结果时返回原处理结果;若另一订单ORDER_B试图认领EVENT_A,则保留冲突待核实。记录交易中其他事件,不等于它们都属于当前充值订单。
七、晚付、金额差异与网络费用怎么处理
| 情况 | 处理原则 |
|---|---|
| 晚到付款 | 保留实际收款,按订单有效期规则核对后补入账或处理售后。 |
| 少付、多付 | 记录应付与实收差异,按约定核实,不擅自凑成另一笔订单。 |
| 错误网络、错误代币 | 停止自动入账,核实资产、地址及控制情况,再联系技术处理。 |
| 确认回退或结果未知 | 保留事件和原订单复核,不重复加款,也不直接要求重转。 |
退款需单独确认对象、网络、数量、费用和授权,不能假设监控服务会自动退款。站内冲正保留独立流水,不通过删除原记录改账;链上转账不会因为修改站内状态而自动撤销。
自有钱包发送TRC20交易涉及Tron带宽、能量及可能消耗的TRX;Ethereum交易燃料费以ETH支付。从交易所提币还要核对其提现费用和实际转出数量。费用按当时网络与发送工具确认,不给所有订单套固定费率。
八、逐笔对账与接入验收
把网络、合约、地址、交易事件、充值订单、入账流水与用户余额关联起来。钱包总余额可能还包含其他收支,不能仅凭余额增长给某个用户充值;也不能把商户自有钱包直收,与微信、支付宝代收后的USDT结算混为一条资金路径。
联调至少验证正常付款、重复通知、主动核查并发、同交易多事件、同地址同额订单、少付多付、晚付、数据库回滚及确认异常。逐项核对事件认领和最终余额,确保不漏记、不重复,也不把同一事件分给两个用户。
钱会先进入稳付pay钱包吗?
不会。客户直接付到商户自己的地址,平台只提供监控和回调,不代收、不托管。
链上看到交易后立即加余额吗?
先核实执行、资产、地址、金额和配置确认条件,再由后端幂等记账。
目前支持与收费怎样确认?
Tron与Ethereum两条网络的监控回调面向中小站长免费开放;企业级服务另行收费。联系技术团队确认订单识别与回调配置,独立代付接口暂未开放。
参考资料
官方资料用于核对资产、链上确认和网络费用;USDT监控与回调的实际协议、确认条件和订单识别规则,以技术团队开通时确认的配置为准。