自动化
n8n 中的加密货币支付
适用于 SnapEX Pay 的 n8n 社区节点。从任何工作流创建加密货币账单，并在账单支付后启动工作流。客户在 SnapEX Pay 页面使用 USDT（TRC20、ERC20、BEP20）或其他支持的币种付款；触发器会校验每个 Webhook 的签名，并可在工作流继续之前从 API 重新读取账单。
免费。版本 1.1.0。
功能
- SnapEX Pay 操作节点（也可作为 AI agent 工具使用）：Create Invoice 返回
invoice_id、status和pay_url；Get Invoice 返回当前账单。 - 每个创建请求都带有
Idempotency-Key；设置 External ID 后，重试会返回同一张账单，而不是创建第二张。 - SnapEX Pay Trigger 在
invoice.paid（默认）及其他账单事件时启动工作流；未选择的事件会被确认并忽略。 - 触发器校验 HMAC-SHA256 签名，拒绝偏差超过 5 分钟的时间戳，对错误签名返回 401，因此不会运行任何工作流。开启 Re-Fetch Invoice 后，会从 API 重新读取账单。
- 无运行时依赖。
Environment = test用于模拟付款，不会转移资金。
安装
- 在 n8n 节点目录（
~/.n8n/nodes，Docker 中为/home/node/.n8n/nodes）中运行npm install https://pay.snapex.pro/downloads/n8n/n8n-nodes-snapex-pay-1.1.0.tgz，然后重启 n8n。 - 创建 SnapEX Pay API 凭据：来自 SnapEX Pay 后台 → Developers 的 API 密钥（权限
invoices.read和invoices.write）。凭据对话框中的 Test 会检查密钥及其invoices.read权限。 - 向工作流添加 SnapEX Pay Trigger，选择事件并复制该节点的 Production URL。
- 在后台 → Developers → Webhook 中粘贴该 URL 并保存，然后将
whsec_…密钥复制到凭据的 Webhook Secret 中。 - 激活工作流。使用
Environment = test搭建；只有当invoice.status为paid时才交付商品。
设置
| API Key | SnapEX Pay 后台 → Developers → Merchant API key，权限 invoices.read 和 invoices.write。 |
|---|---|
| Webhook Secret | 首次在后台保存 Webhook URL 时显示一次的 whsec_… 密钥。仅触发器需要。 |
| Create Invoice | Amount USD（最低金额由 SnapEX Pay 设定）、External ID、Description、Success 和 Cancel URL、Fee Paid By、Environment、Expires In（1–1440 分钟）。 |
| Trigger events | invoice.paid、invoice.partially_paid、invoice.underpaid、invoice.expired、invoice.extra_payment、invoice.created、invoice.awaiting。 |
| Partner ID | 凭据中的可选字段：为您配置此节点的集成商的 Partner ID（SnapEX Pay 推荐计划）。如果是您自己安装，请留空。 |
常见问题
该节点在 npm 仓库中吗？
暂时没有。请在 n8n 节点目录中使用 npm install <archive URL> 从本页面的压缩包安装。
如何避免重复交付？
SnapEX Pay 会重试未收到 2xx 响应的投递，因此请使用 webhook_id 或 invoice_id 让交付保持幂等，并且只在 invoice.status 为 paid 时交付。
可以在 AI agent 中使用吗？
可以。SnapEX Pay 操作节点可以作为 AI agent 工具使用。
为什么激活失败？
触发器需要凭据中的 Webhook Secret；如果缺少，激活会失败并给出明确提示。
准备好接收加密货币了吗？
创建商户账户，获取 API 密钥并连接模块。每笔支付 1%，无月费。