如何在自己的网站上接受 USDT 付款
选择 USDT 的网络与代币,为网站连接收款地址,展示准确的付款信息,并区分转账已发送与订单已付款。
更新日期:
要在网站上接受 USDT,请先准备所选网络的收款地址,将其连接到 Cryptanio 的相应服务,并向买家展示这笔付款的具体信息。单次付款可以使用支付链接。对于自动管理订单的商店,更适合为每次购买创建单独的账单。
本指南重点介绍 USDT 的使用细节:如何区分网络、代币与标价币种,以及如何正确核实到账情况。网站接入的整体流程见另一篇指南。
先确定接受哪一种 USDT
USDT存在于多个区块链上。因此,仅写“使用 USDT 付款”还不够,还必须明确网络。两个应用中的地址格式相同、代币简称相同,并不能证明转账兼容。
对于选定的付款方式,请同时核实以下三个条件:
- 收款方钱包支持该网络上的 USDT,并能提供合适的收款地址;
- Cryptanio 允许在项目的相应服务中使用这一网络与资产组合;
- 付款方的钱包或服务能够发送这一具体版本的 USDT。
请通过 Tether 官方目录核对代币标识符,不要只看名称和图标。目录也保留了已停止支持的协议的历史信息:存在旧条目,并不代表目前仍支持该协议。Cryptanio 中的可用性需要单独核实。目录核对日期为 2026 年 11 月 14 日。
准备地址并连接正确的资产
在管理面板中选择网站项目,并确保用于账单的 Payments 服务或用于支付链接的 Links 服务已启用。添加公开收款地址,或从地址簿中选择地址,再将其连接到对应服务。仅将地址保存在地址簿中,不会启用该服务的收款功能。
在地址使用设置中检查“资产”字段。接收 USDT 时,这里必须指定所选网络支持的代币。空字段表示网络原生币,而不是 USDT。USDT 等受支持的名称会通过服务目录解析;填写合约或 mint 时,请使用该网络的准确标识符。不要填入其他网络的代币地址。
这种连接不需要助记词,也不需要能够支配资金的私钥。请确认地址属于自己的钱包,并且能够自行管理收到的 USDT。
选择支付链接还是账单
如果网站用于介绍服务,而您手动确认付款,请打开“支付链接”,点击“新付费链接”。设置固定金额,并在可用付款方式中保留所需的 USDT 选项。将生成的永久链接放到网站上。项目中必须有专门连接到 Links 的可用地址。
自动化商店应在服务器端通过 API v1 创建账单。预先选定资产时,需要提供 project、chain、asset,以及以 USDT 为单位的字符串 amount。以美元表示的订单价格和预期收到的加密货币金额用途不同:以 USD 报价不意味着接收美元,也不意味着兑换收到的代币。
保存订单与账单 ID 的对应关系。新操作使用唯一的 Idempotency-Key,发生故障后重试同一请求时,应保留原来的键。秘密 API 密钥必须留在服务器端。
展示准确的付款信息,不要舍入或替换
买家需要当前页面或账单响应中的网络、资产、地址、准确金额和付款期限。如果指定了必填的 memo、destination tag 或其他附加信息,也必须一并传递。二维码应使用返回的 payment_uri(如有):不要仅凭地址重新拼装,也不要丢失附加信息。
不要用商品页面上舍入后的价格替换准确金额。不要因为价值接近,就承诺可以用 USDC 或其他代币代替 USDT。买家切换付款方式后,必须使用当前付款尝试的最新信息,而不是之前保存的地址。
还应单独检查 USDT 转账手续费:钱包需要使用什么资产支付手续费,以及卖家最终实际收到多少。手续费不应在没有提示的情况下减少订单应收到的金额。
根据账单核实付款
截图、买家的消息和检测到的交易,都不足以证明订单已全额付款。自动处理时应检查账单的当前状态;成功状态是 paid。少付、部分付款、多付或迟到的转账,都可能需要单独作出决定。
服务器可以接收带签名的 webhook,再通过 API 核实结果,也可以不使用 webhook,直接通过 API 查询状态。重复事件或重复检查不应导致二次发货。需要实现通知处理程序时,请参考 webhook 指南。
第一笔订单前需要检查什么
从买家角度打开付款页面,核对网络、资产和付款信息。如果用真实转账测试,应考虑手续费并使用自己的资金:仅打开页面并不能核实到账。
如果转账已经发出但订单仍未付款,请保存 TXID,检查网络、准确的代币、实际收到的金额和确认情况。处理少付及网站错误的流程见未付款订单指南。