跳到正文

n8n 社区节点

在 n8n 工作流中接受加密货币支付

从任意 n8n 工作流创建 ArionPay 账单,并在付款确认后运行您自己的步骤。客户直接付款到您自己的钱包:ArionPay 从不持有资金。

观看设置视频

在 n8n 中:Settings › Community Nodes › Install,然后输入

n8n-nodes-arionpay
GitHub 上的源代码
示例

功能介绍

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. 第 1 步

    安装节点

    在 n8n 中进入 Settings > Community Nodes > Install,输入 n8n-nodes-arionpay 并确认。

  2. 第 2 步

    添加您的凭据

    用您的 API key、API secret 和 Webhook signing secret 创建 ArionPay API 凭据。点击“Test”会发送一个签名请求,但不会更改任何内容。

  3. 第 3 步

    添加 Webhook 节点

    将“HTTP Method”设为 POST,“Respond”设为“When Last Node Finishes”,“Response Data”设为“No Response Body”。在“Options”下添加“Raw Body”并将其开启。

  4. 4

    第 4 步

    先校验,再执行您的步骤

    在它之后添加 ArionPay > Webhook > Verify Webhook,并选择您需要的事件(默认 Invoice Paid)。然后添加您自己的步骤,用 invoice.orderId 或 invoice.metadata 找到对应订单。

  5. 第 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。输出字段保持不变。