مدفوعات العملات المشفرة في n8n
عقدة مجتمعية لـ n8n خاصة بـ SnapEX Pay. أنشئ فواتير بالعملات المشفرة من أي سير عمل، وابدأ سير عمل عند دفع فاتورة. يدفع العملاء بـ USDT (TRC20 وERC20 وBEP20) أو بعملات أخرى مدعومة على صفحة SnapEX Pay؛ ويتحقق المشغّل (trigger) من توقيع كل إشعار Webhook، ويمكنه قراءة الفاتورة مجددًا من API قبل أن يتابع سير العمل.
مجانًا. الإصدار 1.1.0.
ماذا تفعل الوحدة
- عقدة إجراء SnapEX Pay (يمكن استخدامها أيضًا أداةً لوكيل ذكاء اصطناعي): تُرجع 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. - أنشئ بيانات اعتماد (credential) من نوع SnapEX Pay API: مفتاح API من لوحة تحكم SnapEX Pay ← للمطورين (بالصلاحيتين
invoices.readوinvoices.write). يتحقق زر Test في نافذة بيانات الاعتماد من المفتاح ومن صلاحيتهinvoices.read. - أضف SnapEX Pay Trigger إلى سير عمل، واختر الأحداث، وانسخ Production URL الخاص بالعقدة.
- في لوحة التحكم ← للمطورين ← Webhook الصق ذلك العنوان واحفظه، ثم انسخ السر
whsec_…إلى حقل Webhook Secret في بيانات الاعتماد. - فعّل سير العمل. ابنِه مع
Environment = test؛ وسلّم البضاعة فقط عندما تكونinvoice.statusبقيمةpaid.
الإعدادات
| API Key | لوحة تحكم SnapEX Pay ← للمطورين ← مفتاح API التاجر، بالصلاحيتين invoices.read وinvoices.write. |
|---|---|
| Webhook Secret | السر whsec_… الذي يظهر مرة واحدة فقط، عند حفظ عنوان Webhook أول مرة في لوحة التحكم. مطلوب للمشغّل فقط. |
| 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؟
ليس بعد. ثبّتها من الأرشيف الموجود في هذه الصفحة عبر npm install <archive URL> في مجلد عقد n8n.
كيف أتجنب تنفيذ الطلب مرتين؟
يعيد SnapEX Pay محاولة التسليم الذي لم يتلقَّ استجابة 2xx، لذا اجعل تنفيذ الطلب آمنًا عند التكرار (idempotent) باستخدام webhook_id أو invoice_id، ولا تسلّم إلا عندما تكون invoice.status بقيمة paid.
هل يمكنني استخدامها في وكيل ذكاء اصطناعي؟
نعم. يمكن استخدام عقدة إجراء SnapEX Pay أداةً لوكيل ذكاء اصطناعي.
لماذا يفشل التفعيل؟
يحتاج المشغّل إلى Webhook Secret في بيانات الاعتماد؛ وإذا كان مفقودًا يفشل التفعيل مع رسالة واضحة.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.