پرداخت کریپتو در n8n
یک نود community برای n8n که با SnapEX Pay کار میکند. از هر workflow فاکتور کریپتو بسازید و وقتی فاکتوری پرداخت شد یک workflow را اجرا کنید. مشتریان در صفحه SnapEX Pay با USDT (TRC20، ERC20، BEP20) یا کوین‌های پشتیبانی‌شده دیگر پرداخت می‌کنند؛ تریگر امضای هر وب‌هوک را بررسی میکند و می‌تواند پیش از ادامه workflow فاکتور را دوباره از API بخواند.
رایگان. نسخه 1.1.0.
چه کاری انجام می‌دهد
- نود اکشن SnapEX Pay (قابل استفاده بهعنوان ابزار AI agent): Create Invoice مقادیر
invoice_id،statusوpay_urlرا برمی‌گرداند؛ Get Invoice فاکتور فعلی را برمی‌گرداند. - هر درخواست ساخت یک
Idempotency-Keyدارد؛ با External ID، تکرار درخواست همان فاکتور را برمی‌گرداند و فاکتور دوم ساخته نمی‌شود. - SnapEX Pay Trigger یک workflow را با
invoice.paid(پیش‌فرض) و رویدادهای دیگر فاکتور اجرا میکند؛ رویدادهایی که انتخاب نکرده‌اید تأیید و نادیده گرفته می‌شوند. - تریگر امضای HMAC-SHA256 را بررسی میکند، زمان‌هایی با اختلاف بیش از ۵ دقیقه را رد میکند و به امضای نادرست 401 پاسخ می‌دهد، پس هیچ workflowی اجرا نمی‌شود. با روشن بودن 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 را ری‌استارت کنید. - یک credential از نوع SnapEX Pay API بسازید: کلید API از پنل SnapEX Pay → Developers (دسترسی‌های
invoices.readوinvoices.write). دکمه Test در پنجره credential کلید و دسترسیinvoices.readآن را بررسی میکند. - SnapEX Pay Trigger را به یک workflow اضافه کنید، رویدادها را انتخاب کنید و Production URL نود را کپی کنید.
- در پنل → Developers → Webhook آن URL را وارد و ذخیره کنید، سپس رمز
whsec_…را در Webhook Secret مربوط به credential کپی کنید. - workflow را فعال کنید. با
Environment = testبسازید؛ کالا را فقط وقتی تحویل دهید کهinvoice.statusبرابرpaidباشد.
تنظیمات
| API Key | پنل SnapEX Pay → Developers → Merchant API key، دسترسی‌های invoices.read و invoices.write. |
|---|---|
| Webhook Secret | رمز whsec_… که فقط یک بار، هنگام اولین ذخیره URL وب‌هوک در پنل، نمایش داده می‌شود. فقط برای تریگر لازم است. |
| Create Invoice | Amount USD (حداقل را SnapEX Pay تعیین میکند)، External ID، Description، Success و Cancel URL، Fee Paid By، Environment، Expires In (۱ تا ۱۴۴۰ دقیقه). |
| Trigger events | invoice.paid، invoice.partially_paid، invoice.underpaid، invoice.expired، invoice.extra_payment، invoice.created، invoice.awaiting. |
| Partner ID | فیلد اختیاری credential: Partner ID یکپارچه‌سازی که نود را راه‌اندازی کرده است (برنامه معرفی SnapEX Pay). اگر خودتان نصب می‌کنید، خالی بگذارید. |
سؤالات
آیا نود در رجیستری npm هست؟
هنوز نه. آن را از آرشیو همین صفحه با npm install <archive URL> در پوشه نودهای n8n نصب کنید.
چطور از تحویل دوباره جلوگیری کنم؟
SnapEX Pay ارسالی را که پاسخ 2xx نگرفته دوباره تلاش میکند، پس تحویل را با webhook_id یا invoice_id idempotent کنید و فقط وقتی تحویل دهید که invoice.status برابر paid باشد.
آیا میتوانم آن را در یک AI agent استفاده کنم؟
بله. نود اکشن SnapEX Pay را میتوان بهعنوان ابزار AI agent استفاده کرد.
چرا فعال‌سازی ناموفق است؟
تریگر به Webhook Secret در credential نیاز دارد؛ اگر نباشد، فعال‌سازی با پیامی روشن ناموفق می‌شود.
یکپارچه‌سازی‌های دیگر
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.