跳转到主要内容
使用付款 API 从您的 XPayLabs 网关钱包向任何外部区块链地址发送加密支付。支持 TRON、EVM 链和 SUI 上的 USDT、USDC 及其他稳定币。

如何创建付款

调用 POST /v1/order/createPayout,传入目标地址、金额、代币符号和链信息:

请求参数

参数必填描述
amount十进制字符串格式的金额(例如 "50.00"
symbol代币符号(例如 "USDT"
chain区块链网络
receiveAddress目标区块链地址
orderId此付款的标识符
uid您的用户标识符

地址验证

网关在处理前会验证 receiveAddress 的格式是否与指定链匹配:
地址格式示例
TRONBase58,以 T 开头TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR
EVM(ETH、BSC、POLYGON)十六进制,以 0x 开头0x05E833cF6a895a9ABe408FD6a8d5e0d3DB2Fec5A
SUI十六进制,以 0x 开头0x24f672b38299ae651f7598f4994ade780c38aeffa4e595c79ab73d3d176543cd
如果地址格式无效,API 返回 "ReceiveAddress error"

如何跟踪付款状态

创建付款后,使用订单状态端点跟踪其状态:

有哪些付款状态?

状态描述
PENDING付款已创建,等待处理
PENDING_CONFIRMATION交易已提交到区块链
SUCCESS付款已在链上确认
FAILED付款失败(余额不足等)

付款会触发哪些 Webhook 事件?

付款同样会触发 Webhook 事件:
事件触发时机
ORDER_PENDING付款订单已创建
ORDER_PENDING_CONFIRMATION交易已提交
ORDER_SUCCESS付款已在链上确认
ORDER_FAILED付款失败

重要安全说明

  • 区块链交易不可逆转。提交前请仔细检查 receiveAddress
  • 网关验证地址格式,但无法验证地址是否属于预期的接收者。
  • 付款消耗区块链 gas 费用(TRON 消耗 TRX,EVM 链消耗 ETH gas)。
  • 发起付款前,请确保您的热钱包有足够余额(包括 gas 代币)。
最后修改于 2026年6月26日