跳到正文

n8n 视频指南

将 n8n 接入加密货币支付网关

从任意 n8n 工作流创建加密货币账单,并在付款确认后运行您自己的步骤。用不到三分钟看完整个设置过程,然后按照六个步骤操作。客户直接付款到您自己的钱包。

观看视频(2:28)免费开始

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

n8n-nodes-arionpay
示例

实际效果演示

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

    安装节点

    在 n8n 中打开 Settings › Community nodes,点击 Install。输入 n8n-nodes-arionpay,确认有关社区代码的提示,然后安装。

    n8n 会从 npm 下载该软件包,并添加一个节点:ArionPay。该软件包没有其他依赖。

    n8n 设置中的 Community nodes:已安装 n8n-nodes-arionpay 2.0.0 版本,包含一个节点 ArionPay
  2. 2

    添加您的 API 凭据

    创建一个类型为 ArionPay API 的凭据,粘贴 ArionPay 控制台中的 API key、API secret 和 Webhook 签名密钥。ArionPay Address 保持不变:https://merchant.arionpay.com。

    保存时,n8n 会用一个不做任何更改的签名请求测试这些密钥。在视频中,错误的密钥先被拒绝,之后正确的密钥显示“Connection tested successfully”。

    n8n 中的 ArionPay 账户凭据,含 API key、API secret 和 Webhook 签名密钥,显示“Connection tested successfully”
  3. 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 发送。

    一个已激活的 n8n 工作流:Webhook,然后是 Verify ArionPay webhook,然后是 Mark order as paid
  4. 4

    创建测试账单并支付

    在任意工作流中,ArionPay › Invoice › Create 会创建账单:填写金额和货币,开启 Test Invoice,并在 Additional Fields 下填写币种、您的订单号和回调 URL。

    ArionPay 会返回该账单,其中包括它的支付页面(invoiceUrl):这就是您要引导客户前往的地方。在测试模式下,ArionPay › Invoice › Simulate Test Payment 会用模拟资金支付它。

    n8n 中的 ArionPay Create invoice 节点:25 USD、测试账单、币种为 TRON 上的 USDT,输出中显示新账单及其 invoiceUrl
  5. 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 标记为已支付。

    收到已支付 Webhook 后的 n8n:左侧是已校验的 invoice.paid 事件,订单 ORDER-1001 已标记为已支付,含 25 USDT 和交易 ID
  6. 6

    伪造的 Webhook 会被拒绝

    您的 Webhook 地址是公开的,因此任何人都可以向它发送伪造的“invoice.paid”。Verify Webhook 会用您的签名密钥校验基于完整请求正文的 HMAC 签名,并检查时间戳。

    在视频中,一个签名错误的伪造更新在 Verify Webhook 处被拦下,显示“Invalid signature”。其后的步骤都不会运行,订单也不会被标记为已支付。

    n8n 在 Verify ArionPay webhook 处拦下伪造的 Webhook,并显示错误:Not a valid ArionPay 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、测试、币种和费用。

暂时不行。n8n Cloud 只提供经 n8n 验证的社区节点,我们已提交 ArionPay 节点申请验证。在此之前,请使用自部署的 n8n,在那里可以安装任何社区节点。