n8n 视频指南
将 n8n 接入加密货币支付网关
从任意 n8n 工作流创建加密货币账单,并在付款确认后运行您自己的步骤。用不到三分钟看完整个设置过程,然后按照六个步骤操作。客户直接付款到您自己的钱包。
实际效果演示
n8n 与 ArionPay:从安装到订单付清
安装节点、连接密钥、接收签名的付款更新,并看到伪造的更新被拒绝。选择章节即可跳转。
在自部署的 n8n 1.123.96 上配合本地 ArionPay 测试服务器一次录制完成,使用测试模式:不涉及真钱。无声音;字幕在画面中,每个步骤也都在下方以文字列出。
开始之前
您需要准备的
- 一个 ArionPay 账户:注册只需电子邮箱。免费创建一个。
- 允许使用社区节点的自部署 n8n。已在 n8n 1.123.96(Node.js 22)上测试,尚未在 n8n 2.x 上测试。
- 您的 API key、API secret 和 Webhook 签名密钥,可在 ArionPay 控制台中获取。
- 如需真实付款,需在控制台中连接您自己的钱包。测试账单不需要真钱。
分步说明
六步将 n8n 接入 ArionPay
- 1
安装节点
在 n8n 中打开 Settings › Community nodes,点击 Install。输入 n8n-nodes-arionpay,确认有关社区代码的提示,然后安装。
n8n 会从 npm 下载该软件包,并添加一个节点:ArionPay。该软件包没有其他依赖。
- 2
添加您的 API 凭据
创建一个类型为 ArionPay API 的凭据,粘贴 ArionPay 控制台中的 API key、API secret 和 Webhook 签名密钥。ArionPay Address 保持不变:https://merchant.arionpay.com。
保存时,n8n 会用一个不做任何更改的签名请求测试这些密钥。在视频中,错误的密钥先被拒绝,之后正确的密钥显示“Connection tested successfully”。
- 3
构建接收付款的工作流
添加 n8n 自带的 Webhook 节点:HTTP Method 设为 POST,Respond 设为“When Last Node Finishes”,Response Data 设为“No Response Body”,并在 Options 下添加 Raw Body 并将其开启。
在其后添加 ArionPay › Webhook › Verify Webhook,并选择您需要的事件(默认为 Invoice Paid)。然后添加您自己的步骤:发送文件、授予访问权限或将订单标记为已支付。
激活工作流,并将 Webhook 节点的 Production URL 复制到 ArionPay 控制台的 Webhooks 页面,或在每张账单中作为 Callback URL 发送。
- 4
创建测试账单并支付
在任意工作流中,ArionPay › Invoice › Create 会创建账单:填写金额和货币,开启 Test Invoice,并在 Additional Fields 下填写币种、您的订单号和回调 URL。
ArionPay 会返回该账单,其中包括它的支付页面(invoiceUrl):这就是您要引导客户前往的地方。在测试模式下,ArionPay › Invoice › Simulate Test Payment 会用模拟资金支付它。
- 5
收到已支付 Webhook
ArionPay 对 invoice.paid 更新进行签名并发送到您的工作流。Verify Webhook 会校验它,并只向下传递一次,即使 ArionPay 再次投递也是如此。
您的下一步可以获得所需的一切:invoice.orderId 对应订单,invoice.amountFiat 和 invoice.currency 表示付款金额,invoice.paidCrypto 和 invoice.asset 表示币种,invoice.transactions[0].txid 表示区块链交易。在视频中,一个 Set 节点将订单 ORDER-1001 标记为已支付。
- 6
伪造的 Webhook 会被拒绝
您的 Webhook 地址是公开的,因此任何人都可以向它发送伪造的“invoice.paid”。Verify Webhook 会用您的签名密钥校验基于完整请求正文的 HMAC 签名,并检查时间戳。
在视频中,一个签名错误的伪造更新在 Verify Webhook 处被拦下,显示“Invalid signature”。其后的步骤都不会运行,订单也不会被标记为已支付。
设置完成后
付款状态更新如何送达
- Invoice Paid 表示已全额付清并已确认。这包括逾期付款、在您店铺付款容差范围内(默认 1%)的小额差异,以及您在 Payment Radar 中接受的付款。
- 金额不准确的付款,在您于控制台中做出决定之前,绝不会以已支付状态送达。
- 未通过校验的更新(签名密钥错误、签名错误或过旧)会使工作流失败,因此 ArionPay 会在之后重新发送,持续约 3 天。
- 您未选择的事件会以 200 响应静默结束工作流。
- 控制台中“Send test webhook”发出的事件描述的是一张虚构的账单,除非您开启,否则会被跳过。
- 交付之前,请检查 invoice.amountFiat 和 invoice.currency,并确认真实销售的 invoice.test 为 false。
为何选择 ArionPay
您将获得
直接付到您自己的钱包
客户直接付款到您的钱包。ArionPay 从不持有资金,因此没有需要提现的余额。
签名更新,替您校验
Verify Webhook 会校验每一个付款更新,并将每个事件只传递一次。伪造或重放的请求会在此被拦下。
先用测试模式
用测试账单和模拟付款构建并试用整个工作流,然后切换到真实付款。
任意后续步骤
给客户发邮件、在表格中添加一行、授予访问权限或在聊天中发帖:n8n 能做的任何事都可以。ArionPay 按每笔付款收取 0.5%。
该节点是开源的(MIT)。 GitHub 上的源代码 下载视频(6.6 MB)
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 的常见问题
n8n Cloud、测试、币种和费用。





