n8n 社区节点
在 n8n 工作流中接受加密货币支付
从任意 n8n 工作流创建 ArionPay 账单,并在付款确认后运行您自己的步骤。客户直接付款到您自己的钱包:ArionPay 从不持有资金。
示例
功能介绍
n8n 版 ArionPay
n8n-nodes-arionpay 为 n8n 添加一个节点:ArionPay。它可以创建和读取账单、模拟测试付款、列出币种和汇率,并校验 n8n 自带的 Webhook 节点收到的付款更新。
阅读更多
Verify Webhook 会针对原样的请求体校验签名,只把您选择的事件(例如 Invoice Paid)向下传递,且每个事件只传递一次。之后是您自己的步骤:发送文件、开通访问权限,或在您的表格中将订单标记为已支付。- Invoice:创建账单并获取其支付页面地址、读取账单,或模拟一笔测试付款。
- Verify Webhook 针对原样的请求体校验签名,时间窗口为 5 分钟。
- 每个事件只向下传递一次,即使 ArionPay 重复发送也是如此。处于激活状态的工作流会记住最近 300 个事件 ID。
- 选择您需要的事件,还可以让某个工作流只处理测试账单或只处理正式账单。
- Coin 和 Rate:列出 ArionPay 支持的币种以及币价。
- ArionPay API 凭据也可以为 n8n 的 HTTP Request 节点发出的请求签名。
- 无需其他软件包:请求使用 Node 自带的 crypto 模块签名。
要求与许可证
- 适用于
- 支持社区节点的 n8n · 节点 API 版本 1(尚未在 n8n 2.x 上运行过)
- 测试情况
- n8n 1.123.96(Node.js 22)
- 费用
- 插件免费。ArionPay 每笔付款收取 0.5% 手续费,无月费。
- 源代码
- 在 GitHub 上开源(MIT)。
设置
5 步完成设置
第 1 步
安装节点
在 n8n 中进入 Settings > Community Nodes > Install,输入 n8n-nodes-arionpay 并确认。
第 2 步
添加您的凭据
用您的 API key、API secret 和 Webhook signing secret 创建 ArionPay API 凭据。点击“Test”会发送一个签名请求,但不会更改任何内容。
第 3 步
添加 Webhook 节点
将“HTTP Method”设为 POST,“Respond”设为“When Last Node Finishes”,“Response Data”设为“No Response Body”。在“Options”下添加“Raw Body”并将其开启。
- 4
第 4 步
先校验,再执行您的步骤
在它之后添加 ArionPay > Webhook > Verify Webhook,并选择您需要的事件(默认 Invoice Paid)。然后添加您自己的步骤,用 invoice.orderId 或 invoice.metadata 找到对应订单。
第 5 步
粘贴 URL
将 Webhook 节点的“Production URL”复制到 ArionPay 控制台的“Webhooks”页面,或在创建每张账单时填入“Callback URL”。然后激活工作流。
设置完成后
付款状态更新如何送达
- Invoice Paid 表示已全额付清并已确认。这包括逾期付款、在您店铺付款容差范围内(默认 1%)的小额差异,以及您在 Payment Radar 中接受的付款。
- 金额不准确的付款,在您于控制台中做出决定之前,绝不会以已支付状态送达。
- 未通过校验的更新(签名密钥错误、签名错误或过旧)会使工作流失败,因此 ArionPay 会在之后重新发送,持续约 3 天。
- 您未选择的事件会以 200 响应静默结束工作流。
- 控制台中“Send test webhook”发出的事件描述的是一张虚构的账单,除非您开启,否则会被跳过。
- 交付之前,请检查 invoice.amountFiat 和 invoice.currency,并确认真实销售的 invoice.test 为 false。
9 个网络上的 16 种币和代币
全部币种- BTCBitcoin
- ETHEthereum
- USDTEthereum
- USDCEthereum
- BNBBNB Smart Chain
- USDTBNB Smart Chain
- USDCBNB Smart Chain
- POLPolygon
- USDTPolygon
- USDCPolygon
- TRXTRON
- USDTTRON
- LTCLitecoin
- DOGEDogecoin
- BCHBitcoin Cash
- DASHDash
关于 n8n 版 ArionPay 的问题
安装前需要了解的简短解答。
自 2.0.0 版起就没有了:该版本移除了它,以便软件包能通过 n8n 的验证。付款更新通过 n8n 自带的 Webhook 节点进入,随后接 ArionPay > Verify Webhook。输出字段保持不变。
签名覆盖的是 ArionPay 发送的原始字节。如果不开启 Raw Body,Verify Webhook 会停止运行,并提示您将其开启。
可以。创建账单时勾选“Test Invoice”并填写“Coin”,然后使用 ArionPay > Invoice > Simulate Test Payment,或控制台中的“Try a test payment”按钮。
ArionPay 会等待 10 秒的响应。请让 Verify Webhook 之后的步骤保持简短,否则 ArionPay 会再次发送更新,而 Verify Webhook 会将其视为重复并跳过。
该 n8n 社区节点免费开源(MIT 许可证)。ArionPay 从预付手续费余额中收取每笔付款的 0.5%,因此全额款项都会到达您的钱包。无月费,无开通费,新账户可获得 $20 手续费额度。