加密货币联盟支付解决一个非常具体的问题:在不收集任何人的银行信息的情况下,向成千上万的合作伙伴支付几美元,分布在几十个国家。使用 Payora,您可以将多达 500 个收款人粘贴到柜台中或通过 POST 发送到支付 API;一旦提交,批量总额加上费用将立即保留在您的内部余额中,然后支付将遵循您账户配置的审批和释放流程。此帖子是关于何时加密货币中的推荐支付真正优于电汇和 PayPal,没人告诉你的限制,以及如何将整个过程连接到支付周期,以便失败的 cron 运行不会重复支付。
为什么加密货币适合联盟和推荐支付
联盟和收益分享计划的支付形态是传统支付方式处理不好的:许多收款人、小额支付、国际支付、按重复时间表进行。加密货币几乎完全符合这种形态。
- 一个全球支付方式。在马尼拉的一位合作伙伴、拉各斯的一位合作伙伴和布宜诺斯艾利斯的一位合作伙伴以相同的方式、在相同的几分钟内、从相同的余额中获得支付。没有 PayPal 支持的国家矩阵,也没有您的银行悄悄阻止的走廊。
- 微小的最低限额实际上是可行的。4 美元的收益分享佣金对于 15 美元的国际电汇费用来说是一个四舍五入的错误,因此您从不发送它。在一个便宜的网络上支付同样的 4 美元的 USDT,费用是几美分。小额、频繁的支付不再是经济上的负担。
- 没有银行细节摩擦。您为每个合作伙伴收集一个字段——一个地址——而不是一个IBAN、一个路由号码、一个SWIFT/BIC和一个必须匹配的法定名称。为新附属机构入驻就像粘贴,而不是填写表格。
- 快速。一旦您签署,结算在几分钟内到达收款人,而不是通过可能因名称不匹配而退回的电汇需要两到五个工作日。
- 付款是最终的,因此您支付的款项没有退款。附属机构无法像卡片购买者可以争议购买那样撤销您发送给他们的佣金。
最后一点是双向的,这引出了诚实的部分。
诚实的限制
最终性有一个反面:没有追索权如果您批准并释放给欺诈或自我推荐的附属机构的佣金,则无法简单地撤回已完成的链上支付——保护您免受退款的最终性同样适用于您。因此,纪律要求向上游移动:仔细批准,在批处理之前保持对可疑账户的监控,并将确认释放视为不可逆转的时刻。Payora 不会为您筛选附属机构;这个判断留给您的项目。
第二个约束是操作性。提交一个批次——从柜台或 API——保留资金在您的 Payora 余额上并创建一个支付批次,但您不应在提交时将收款人视为已支付。遵循为您的账户配置的批准、释放和状态流程,然后在标记佣金已支付之前验证结果支付状态和交易证据。任何承诺“API 调用,资金瞬间消失并已结算”的人都在描述一种更自动化且风险更高的模型。大额支付架构文档提供了更广泛的背景,但当前的操作步骤应包含在产品文档和您的账户设置中。
两种运行加密附属支付的方式
对于每月或临时运行,柜台是最快的路径。打开大额支付,粘贴最多 500 行的address amount [tag/memo],并提交。批次总额加上每个项目的费用将保留在您的 余额,因此一个批次不能超支,然后您完成该账户的配置审批和释放步骤。XRP 目标标签和 XLM 备忘录放在每行的可选第三个字段中。
对于按固定周期支付的程序,请从 API 驱动它。POST /v1/payout 接受一种货币和最多 500 个项目,并返回一个 201与一个batch_id,该 item_count, total 和 fee。身份验证与 API 其余部分相同,使用 HMAC 方案 — 头部 X-Payora-Key, X-Payora-Timestamp 和 X-Payora-Signature,签名在hex(HMAC-SHA256(api_secret, timestamp . "." . raw_body))内的120秒窗口内。
curl -X POST https://api.payora.money/v1/payout \
-H "X-Payora-Key: $KEY" \
-H "X-Payora-Timestamp: $TS" \
-H "X-Payora-Signature: $SIG" \
-H "Idempotency-Key: rev-share-2026-07" \
-H "Content-Type: application/json" \
-d '{"currency":"USDT","items":[
{"address":"TXy...","amount":"12.50","tag":""},
{"address":"TAb...","amount":"4.00","tag":""}
],"note":"July affiliate rev-share"}'完整的请求和响应形状,以及支付状态和取消端点,位于API 文档。仍在待处理的批次可以通过POST /v1/payout/{id}/cancel取消,这将把保留的余额释放回给你。
幂等性:重试的cron运行永远不会重复支付
这是自动化联盟支付中最重要的细节。Cron作业在中途失败。网络故障在服务器已经创建你的批次后丢失响应,你的重试逻辑触发,现在你距离双重支付每个联盟只差一个紧张的时刻。
发送一个Idempotency-Key头,值在支付周期内保持稳定——例如,周期id本身是理想的rev-share-2026-07第一次请求创建批次;任何携带相同密钥的重试都会返回该相同 batch_id并且不会创建任何新内容。一个在已经提交的密钥下的不同有效负载会作为一个409 idempotency_conflict返回,而不是静默分叉。根据你的计费周期构建密钥,而不是每次尝试一个随机的 UUID,失败的运行可以安全地再次运行。
与 payout.sent webhook 和每个项目的 tx 哈希进行对账
你绝不应该在自己的数据库中基于乐观猜测将佣金标记为 "已支付"。等待证明。在配置的发布流程完成后,Payora 会为批次项目提供交易证据,它会触发一个签名的payout.sent webhook,携带该batch_id和每个项目的链上tx_hash。它是使用与相同 HMAC-SHA256 方案签名和验证的invoice.paid,所以签名验证指南保持不变。
对账循环简单且便于审计:
- 使用周期作为幂等性密钥提交周期的批次。
- 在
payout.sentwebhook上,验证签名,然后通过地址和金额将项目匹配回合作伙伴。 - 将每个
tx_hash与佣金关联,以便合作伙伴询问“我的钱在哪里”时获得区块浏览器链接,而不是支持票。
如果你更愿意轮询,GET /v1/payout/{id}按需返回相同的每项状态和交易哈希。
费用:倾向于选择便宜的网络以进行多次小额支付
在 Payora 上接受资金的费用为 0%。可配置的转移费用(在免费计划中为 1.5%,加上该币种的网络费用)适用于支付,并与批次一起按项保留,而链上网络费用是单独的且不可避免的。对于联盟活动——大量小额支付——网络费用是你赢或输的关键,因此你选择的币种和网络比其他任何事情都更重要。
在 Tron 或像 Polygon 或 Base 这样的便宜 EVM 链上支付 USDT 每次转账只需几美分;在繁忙时段在以太坊主网上以原生 ETH 支付相同的佣金可能会花费超过佣金本身的费用。首先选择网络,然后支付金额就不再重要。指南中有详细的分解。减少加密支付费用.
严格的验证可以防止错误地址给你带来损失
支付请求对输入错误不宽容,因为它是最终的。Payora 在持有任何币之前会验证整个批次:如果任何地址格式不正确或任何金额的小数位数超过该币种支持的范围,整个请求将被拒绝,返回 HTTP 422以及有问题的项目索引。这是故意的全或无——一个运行从不静默地丢弃合作伙伴或截断金额。修复标记的行并重新提交。因为错误的联盟地址会使批次失败而不是消耗资金,所以一个错误粘贴地址的合作伙伴不会让你失去付款。
把它组合起来
Payora上的联盟计划看起来是这样的:合作伙伴提交一个地址,你的平台构建周期的支付列表,你在一个便宜的网络上以周期作为幂等性密钥进行POST,严格的验证捕捉错误的行,你的团队遵循配置的审批和发布流程,payout.sent webhook将交易证据写回每个佣金。创建一个免费账户获取API密钥,或阅读大额支付页面以查看批次流程的端到端。
Comments