n8n'de kripto ödemeler
SnapEX Pay için bir n8n topluluk node'u. Herhangi bir iş akışından kripto faturalar oluşturun ve bir fatura ödendiğinde iş akışı başlatın. Müşteriler SnapEX Pay sayfasında USDT (TRC20, ERC20, BEP20, Solana, TON, Polygon ve diğer ağlar) veya desteklenen diğer kripto paralarla öder; tetikleyici her webhook'un imzasını doğrular ve iş akışınız devam etmeden önce faturayı API'den yeniden okuyabilir.
Ücretsiz. Sürüm 1.1.0.
Ne yapar
- SnapEX Pay eylem node'u (yapay zekâ ajanında araç olarak da kullanılabilir): Create Invoice
invoice_id,statusvepay_urldöndürür; Get Invoice faturanın güncel hâlini döndürür. - Her oluşturma isteği bir
Idempotency-Keytaşır; External ID verilmişse yeniden deneme ikinci bir fatura oluşturmak yerine aynı faturayı döndürür. - SnapEX Pay Trigger,
invoice.paid(varsayılan) ve diğer fatura olaylarında bir iş akışı başlatır; seçmediğiniz olayların alındığı onaylanır, ancak bunlar yok sayılır. - Tetikleyici HMAC-SHA256 imzasını kontrol eder, zaman damgası 5 dakikadan fazla sapan istekleri reddeder ve hatalı imzaya 401 yanıtı verir; böylece hiçbir iş akışı çalışmaz. Re-Fetch Invoice açıkken fatura API'den yeniden okunur.
- Çalışma zamanı bağımlılığı yok.
Environment = testile ödemeler simüle edilir, hiçbir zaman gerçek para hareket etmez.
Kurulum
- n8n node klasöründe (
~/.n8n/nodes, Docker'da/home/node/.n8n/nodes)npm install https://pay.snapex.pro/downloads/n8n/n8n-nodes-snapex-pay-1.1.0.tgzkomutunu çalıştırın ve n8n'i yeniden başlatın. - Bir SnapEX Pay API kimlik bilgisi (credential) oluşturun: SnapEX Pay panelinin “Geliştiriciler” bölümündeki API anahtarı (
invoices.readveinvoices.writeyetkileri). Kimlik bilgisi penceresindeki Test düğmesi anahtarı veinvoices.readyetkisini kontrol eder. - Bir iş akışına SnapEX Pay Trigger ekleyin, olayları seçin ve node'un Production URL'sini kopyalayın.
- SnapEX Pay panelinde “Geliştiriciler” → “Webhook” kartına bu URL'yi yapıştırıp “Kaydet” düğmesine basın, ardından
whsec_…gizli anahtarını kimlik bilgisindeki Webhook Secret alanına kopyalayın. - İş akışını etkinleştirin. Geliştirirken
Environment = testkullanın; ürünü yalnızcainvoice.statusdeğeripaidolduğunda teslim edin.
Ayarlar
| API Key | SnapEX Pay paneli → “Geliştiriciler” → “Üye işyeri API anahtarı”; invoices.read ve invoices.write yetkileriyle. |
|---|---|
| Webhook Secret | Panelde webhook URL'sini ilk kez kaydettiğinizde yalnızca bir kez gösterilen whsec_… gizli anahtarı. Yalnızca tetikleyici için gereklidir. |
| Create Invoice | Amount USD (minimum tutarı SnapEX Pay belirler), External ID, Description, Success ve Cancel URL, Fee Paid By, Environment, Expires In (1–1440 dakika). |
| Trigger events | invoice.paid, invoice.partially_paid, invoice.underpaid, invoice.expired, invoice.extra_payment, invoice.created, invoice.awaiting. |
| Partner ID | İsteğe bağlı kimlik bilgisi alanı: node'u kuran entegratörün Partner ID'si (SnapEX Pay referans programı). Node'u kendiniz kurduysanız boş bırakın. |
Sorular
Node npm registry'sinde yayında mı?
Henüz değil. Bu sayfadaki arşivden, n8n node klasöründe npm install <archive URL> komutuyla kurun.
Siparişin iki kez teslim edilmesini nasıl önlerim?
SnapEX Pay, 2xx yanıtı alamayan gönderimi yeniden dener; bu yüzden teslimatı webhook_id veya invoice_id ile idempotent hâle getirin ve yalnızca invoice.status değeri paid olduğunda teslim edin.
Yapay zekâ ajanında kullanabilir miyim?
Evet. SnapEX Pay eylem node'u yapay zekâ ajanında araç olarak kullanılabilir.
Etkinleştirme neden başarısız oluyor?
Tetikleyici, kimlik bilgisinde Webhook Secret alanının dolu olmasını ister; alan boşsa etkinleştirme anlaşılır bir hata mesajıyla başarısız olur.
Diğer entegrasyonlar
Kripto ile ödeme almaya hazır mısınız?
Üye işyeri hesabı oluşturun, API anahtarı alın ve modülü bağlayın. Ödeme başına %1 komisyon, aylık ücret yok.