要点速览
批量出款需要持久化队列和幂等重试。每次 POST /v1/withdrawals 只对应一位收款人;首次发送前,将 external_order_id 与出款任务一起保存,重试时沿用同一标识和请求内容。后台任务需限制并发,遇到错误时延迟重试。账户的标准限额为每秒 30 次请求,由所有 API 调用共享,并不代表每秒完成 30 笔转账。商户后台仅在生产环境支持手动发放,每次最多 50 位收款人,使用同一资产和网络。Paymos 出款佣金为 0%,另收取已披露的补贴后网络手续费。
对于面向全球的联盟营销网络、在线游戏、数字资产平台及跨国分布式团队而言,高效可靠的加密出款系统是日常运营的生命线。
然而,加密出款无法简单复用传统银行的文件跑批逻辑。公链转账需要等待确认;EVM 同一发送地址还受 Nonce 顺序约束,接入时需处理重试和状态跟踪。
EVM Nonce 机制带来的并发瓶颈
以太坊及兼容链按 Nonce 顺序执行同一账户的交易。如果一笔交易仍在等待,后续交易也可能延迟。自行接入 RPC 时需要管理 Nonce 和待确认交易;API 请求频率与链上完成速度是不同的指标。
事务发件箱模式(Transactional Outbox)
将内部余额变更、出款任务及 external_order_id 保存在同一数据库事务中。每笔出款只分配一个 external_order_id,并在首次请求前保存。后台任务逐笔发送,重试时使用原有标识和相同内容。参考我们的 Webhook 幂等性指南。
多金库密钥轮换分发架构
接入 API 时,无须按热钱包数量估算处理能力。限制队列中同时发送的请求数,并独立跟踪每笔提现的状态。关于密钥安全,请阅读 热钱包安全架构分析。
网络手续费:出款补贴与 TRON 能量
Paymos 出款佣金为 0%。商户只需支付所选路线披露的网络手续费,且每条出款路线都有补贴:商户支付的费用低于链上实际收取的费用。出款失败或被取消时,预留金额和手续费全额退回可用余额。
波场(TRON)的能量等网络资源会影响转账成本。请以所选出款路线披露的手续费为准,不要按固定美元价格估算每笔费用。费用信息请查看 Paymos 价格页面,背景知识参见 TRON 能量租赁指南。
开发者 REST API 接入
您的后端通过 Host-to-Host REST API 为每位收款人发送一次经过认证的 POST /v1/withdrawals。请使用 Payout(rk_)密钥并采用 HMAC-SHA256 认证;目标地址通常需在提现白名单中。示例中的请求头取值均为占位符。
POST /v1/withdrawals HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 rk_live_<key_id>:<base64_signature>
X-Request-Timestamp: <current_unix_seconds>
Content-Type: application/json
{
"currency": "USDT",
"network": "TRC20",
"amount": "25.00",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"external_order_id": "payout_usr_101"
}
创建成功返回 HTTP 201 Created,状态为 created;使用相同 external_order_id 重试,返回 HTTP 200 OK 和已有提现。示例中的金额和手续费仅作说明,并非资费标准:
{
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "created",
"is_final": false,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"created_at": 1739277600
}
每秒 30 次请求的标准账户限额由所有 API 调用共享。请限制后台任务并发,重试时逐步延长等待,收到 HTTP 429 时遵循 Retry-After;该限额不保证转账完成速度。商户后台还支持手动发放,每次最多 50 位收款人,使用同一资产和网络,仅限生产环境。
提现完成后,Paymos 会以带版本号的 webhook 信封发送 withdrawal.completed:
{
"event_id": "evt_CbYeOgBp9Kt2U3j74fxxLl",
"event_type": "withdrawal.completed",
"version": 1,
"occurred_at": 1739281200,
"data": {
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "completed",
"is_final": true,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"tx_hash": "7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"explorer_url": "https://tronscan.org/#/transaction/7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"created_at": 1739277600,
"completed_at": 1739281200
}
}
出款失败时发送 withdrawal.failed,取消时发送 withdrawal.cancelled;两种情况下,预留金额和手续费均全额退回可用余额。请基于原始请求体验证 webhook 签名,按 event_id 去重,并按 data.withdrawal_id 处理业务变更,不要假定事件的送达顺序。withdrawal.completion_rewound 表示已完成提现退回 signed,需继续跟踪后续状态。
了解更多关于 出款结算速度 的内容。
| 架构方案 | 请求发送方式 | Nonce 管理 | 相对 Gas 损耗 | 最佳适用场景 |
|---|---|---|---|---|
| 1. 简单同步 RPC 循环 | 取决于网络和实现方式 | 由接入方管理 | 取决于网络及资源消耗 | 测试环境、小微业余项目 |
| 2. 商户后台手动发放 | 仅限生产环境;同一资产和网络,每次最多 50 位收款人 | 无须自行管理发送地址的 Nonce | 补贴后的网络手续费 | 定期薪酬发放、人工渠道分成 |
| 3. 自动化 API 发件箱 (POST /v1/withdrawals) | 每次请求一位收款人;账户共享每秒 30 次请求限额 | 无须自行管理发送地址的 Nonce | 补贴费率 (0% Paymos 手续费) | 加密交易所、iGaming、大规模做市 |
常见问题
为什么同一地址的后续转账会等待前一笔交易?
EVM 链按 Nonce 顺序执行同一发送地址的交易。如果第 5 笔交易仍在等待,后续交易也可能排队。这不代表所有 API 请求都使用同一个链上队列。
发生网络超时或服务故障时,系统如何避免重复打款?
首次发送前保存每笔出款的 external_order_id。请求超时后,使用同一标识和相同内容重试,API 会返回已有提现,而不创建另一笔。事务发件箱可将任务与内部余额变更保存在同一数据库事务中。
自动化与批量出款如何降低每笔提现的网络费用?
Paymos 出款佣金为 0%,网络手续费有补贴。将任务放入同一队列并不保证降低手续费。商户后台仅在生产环境支持每次最多 50 位收款人的手动发放,使用同一资产和网络。
如果提现目标地址触发了 AML 制裁该如何处理?
在路由提现之前,Paymos 会通过 TRM Labs、Binance AML、AMLBot、PureFi 及筛查服务商的数据库检查收款地址。若地址未通过筛查,提现不会发送,状态变为 failed,预留金额和网络手续费全额退回商户可用余额。
什么时候不该用加密批量出款API
- 通过商户后台手动提现即可满足需求,无须接入 API 的平台。
- 需要专职人工复核的低流动性小众代币或定制 NFT。
- 后端服务无法部署具备原子性保障的事务发件箱模式。
- 合规政策要求每笔出款无论金额大小都须经两人审批:Paymos 没有多人审批链,请在调用 API 之前于自有后台实现该流程。
参考来源
最近复核:2026年11月7日


