RU
Автоматизация

Криптоплатежи в n8n

Community-нода n8n для SnapEX Pay. Создавайте криптосчета из любого сценария и запускайте сценарий, когда счёт оплачен. Клиенты платят в USDT (TRC20, ERC20, BEP20) или других поддерживаемых монетах на странице SnapEX Pay; триггер проверяет подпись каждого вебхука и может перечитать счёт из API, прежде чем сценарий продолжится.

Скачать модуль

Бесплатно. Версия 1.0.0.

Что умеет модуль

  • Нода SnapEX Pay (можно использовать как инструмент AI-агента): 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.
  • Проверено на n8n 2.42.6, без зависимостей. Environment = test — тестовые платежи без движения денег.

Установка

  1. В папке нод n8n (~/.n8n/nodes, в Docker — /home/node/.n8n/nodes) выполните npm install https://pay.snapex.pro/downloads/n8n/n8n-nodes-snapex-pay-1.0.0.tgz и перезапустите n8n.
  2. Создайте credential SnapEX Pay API: API-ключ из кабинета SnapEX Pay → Developers (права invoices.read и invoices.write). Кнопка Test в диалоге проверит ключ.
  3. Добавьте в сценарий SnapEX Pay Trigger, выберите события и скопируйте Production URL ноды.
  4. В кабинете → Developers → Webhook вставьте этот адрес и сохраните, затем скопируйте секрет whsec_… в поле Webhook Secret credential.
  5. Активируйте сценарий. Собирайте с Environment = test; выдавайте товар, только когда invoice.status = paid.

Настройки

API KeyКабинет SnapEX Pay → Developers → Merchant API key, права invoices.read и invoices.write.
Webhook SecretСекрет whsec_…, который показывается при сохранении адреса вебхука. Нужен только триггеру.
Create InvoiceAmount USD (минимум задаёт SnapEX Pay), External ID, Description, Success и Cancel URL, Fee Paid By, Environment, Expires In (1–1440 минут).
События триггераinvoice.paid, invoice.partially_paid, invoice.underpaid, invoice.expired, invoice.extra_payment, invoice.created, invoice.awaiting.

Вопросы

Нода есть в npm?

Пока нет. Установите её из архива на этой странице: npm install <адрес архива> в папке нод n8n.

Как не выдать товар дважды?

SnapEX Pay повторяет доставку без ответа 2xx, поэтому делайте выдачу идемпотентной по webhook_id или invoice_id и выдавайте товар только при invoice.status = paid.

Можно использовать в AI-агенте?

Да. Ноду SnapEX Pay можно подключить как инструмент AI-агента.

Почему сценарий не активируется?

Триггеру нужен Webhook Secret в credential; без него активация завершается понятной ошибкой.

Готовы принимать крипту?

Создайте аккаунт мерчанта, получите API-ключ и подключите модуль. 1% с платежа, без абонентской платы.