Paymenter için kripto ödemeler
Açık kaynaklı hosting faturalandırma paneli Paymenter için bir ödeme geçidi eklentisi. Müşteri ödenmemiş bir faturada SnapEX Pay'i seçer ve USDT ile TRC20, ERC20, BEP20, Solana, TON veya başka bir ağda ya da SnapEX Pay sayfasında sunulan diğer kripto paralarla öder. İmzalı bir webhook ödemeyi kaydeder ve Paymenter faturası Paid durumuna geçer.
Ücretsiz. Sürüm 1.1.0.
Ne yapar
- Admin → Gateways bölümünde görünen, Paymenter v1 için yerel bir ödeme geçidi eklentisi.
- Webhook'lar HMAC-SHA256 ve 5 dakikalık zaman aralığıyla doğrulanır; herhangi bir ödeme kaydedilmeden önce fatura SnapEX Pay API'sinden yeniden okunur.
- Ödemeler yalnızca bir kez kaydedilir: tekrar gelen webhook ikinci bir işlem eklemez. İşlenen tutar, fatura para biriminde tam olarak faturalanan tutardır.
- Her Paymenter sitesi yalnızca kendi faturalarını kapatır (faturalar
APP_URLdeğerinin hash'iyle işaretlenir). - Gerçek para olmadan onaylanan test faturalarıyla test modu; ödeme geçidi canlı moddayken test ödemeleri yok sayılır. USD ile faturalama yapmayan mağazalar için sabit USD kuru.
Kurulum
- Arşivi açın ve klasörünü Paymenter dizinine
extensions/Gateways/SnapexPay/olarak koyun (SnapexPay.phpveroutes.phpiçinde olacak şekilde; klasör adı sınıf adıyla aynı olmalıdır). Docker imajında/app/extensions/Gateways/SnapexPayyolunu kullanın. - Ödeme geçidi görünmüyorsa
composer dump-autoload -ovephp artisan optimize:clearkomutlarını çalıştırın. - Paymenter'da Admin → Gateways → New bölümüne gidin, SnapEX Pay'i seçin ve SnapEX Pay panelinden aldığınız API anahtarını (yetkiler:
invoices.read,invoices.write) yapıştırın. - SnapEX Pay panelinin “Geliştiriciler” bölümünde webhook URL'sini
https://<your-paymenter>/extensions/snapexpay/webhookolarak ayarlayın vewhsec_…gizli anahtarını (yalnızca bir kez, URL ilk kaydedildiğinde gösterilir) Webhook secret alanına yapıştırın. - Environment ayarını
testyapın, bir faturayı ödeyin ve test ödemesini SnapEX Pay sayfasında onaylayın; fatura Paid durumuna geçmelidir. Ardından ayarı yenidenliveyapın.
Ayarlar
| API key | SnapEX Pay panelinin “Geliştiriciler” bölümünden; invoices.read ve invoices.write yetkileriyle. |
|---|---|
| Webhook secret | Webhook endpoint'inin whsec_… gizli anahtarı. İmzasız ya da yanlış imzalı webhook'lar reddedilir. |
| Network fee paid by | merchant: müşteri fatura tutarını öder, komisyon size gelen tutardan kesilir. customer: SnapEX Pay komisyonu ve ağ ücreti tutarın üzerine eklenir. |
| Payment window, minutes | 1–1440, varsayılan 60. |
| USD per 1 invoice currency | Paymenter USD ile faturalıyorsa 1; EUR için, kur 1,08 USD ise 1.08 girin. |
| Environment | live veya test. |
| Partner ID | İsteğe bağlı: modülü kuran entegratörün Partner ID'si (SnapEX Pay referans programı). Modülü kendiniz kurduysanız boş bırakın. |
| API URL | Olduğu gibi bırakın. |
Sorular
Ödeme geçidi Admin → Gateways listesinde görünmüyor.
extensions/Gateways/SnapexPay/SnapexPay.php yolunu (büyük/küçük harf önemlidir) ve web sunucusunun dosyayı okuyabildiğini kontrol edin, ardından composer dump-autoload -o && php artisan optimize:clear komutunu çalıştırın.
Müşteri ödedi ama fatura hâlâ ödenmemiş görünüyor.
SnapEX Pay panelindeki webhook gönderim geçmişini kontrol edin. 400 invalid signature, gizli anahtarın eşleşmediği ya da sunucu saatinin kaydığı anlamına gelir; not_paid ise ödemenin o anda henüz onaylanmadığını gösterir; fatura invoice.paid webhook'u geldiğinde kapanır.
Müşteri fatura tutarından az ödedi.
Kısmen ödenmiş faturalar otomatik olarak işlenmez. Ödemeyi SnapEX Pay panelinde kontrol edin ve işlemi Paymenter'a elle ekleyin.
Birden fazla Paymenter sitesi tek bir SnapEX Pay hesabını kullanabilir mi?
Her site yalnızca kendi faturalarını kapatır (faturalar APP_URL değerinin hash'iyle işaretlenir), ancak bir SnapEX Pay hesabının tek bir webhook URL'si vardır ve eklenti ödemeleri yalnızca webhook'tan kaydeder. Bu yüzden ödemeler yalnızca webhook olarak ayarlanmış sitede otomatik olarak kaydedilir.
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.