Kripto ödemeleri gerçek para olmadan nasıl test edilir

SnapEX Pay'de kripto ödemeleri test edin

Bir mağazayı, faturalandırma panelini veya botu kripto ödemeye geçirmeden önce tüm akışın çalıştığını görmek istersiniz: fatura oluşturulur, müşteri bir kripto para seçer, ödeme onaylanır ve sisteminiz siparişi ödendi olarak işaretler. SnapEX Pay'de bunların hepsini tek bir coin bile göndermeden yapabilirsiniz.

Test faturası nedir

Test faturası, environment değeri test olan sıradan bir SnapEX Pay faturasıdır. Canlı bir faturayla aynı durumlardan geçer ve aynı webhook'ları gönderir; her olayda data.environment değeri "test" olur. Gerçek bakiyenizi asla değiştirmez.

Ayrı test API anahtarları yoktur: aynı anahtarı kullanırsınız, istekte yalnızca bir alanı değiştirirsiniz.

API üzerinden test faturası oluşturun

Fatura oluşturan isteğe "environment": "test" ekleyin:

curl -sS -X POST https://pay.snapex.pro/api/v1/merchant/invoices \
  -H "Authorization: Bearer <your API key>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: order-15-test" \
  -d '{
    "amount_usd": "15.00",
    "environment": "test",
    "external_id": "order-15"
  }'

Anahtarın invoices.write yetkisine sahip olması gerekir. Yanıt, canlı bir faturada olduğu gibi ödeme linkini içerir.

Ya da üye işyeri panelinde oluşturun

Panelde “Faturalar” bölümünü açın ve modu “Test” olarak değiştirin (“Mod: Test”). Orada oluşturduğunuz faturalar test faturasıdır ve liste yalnızca test faturalarını gösterir; böylece gerçek ödemelerle asla karışmazlar.

Faturayı ödeyin

Ödeme linkini açın. Sayfada Test etiketi görünür. Herhangi bir kripto para ve ağ seçin: sayfa (gerçek olmayan) bir test adresi gösterir ve yaklaşık 10 saniye sonra ödeme kendiliğinden onaylanır. Hiçbir şey göndermeniz gerekmez.

Kendi tarafınızda neleri kontrol etmelisiniz

Webhook gönderimi. Endpoint'inize data.environment = "test" ile invoice.paid gelir. İmzanın doğrulandığını ve aynı Webhook-Id ile tekrarlanan bir gönderimin siparişi ikinci kez ödendi olarak işaretlemediğini kontrol edin.
Sipariş durumu. Sisteminizdeki sipariş yalnızca invoice.paid geldiğinde ödendi durumuna geçmelidir.
Canlı ve test birbirine karışmamalı. Canlı moda geçtiğinizde kodunuzun test olaylarını yok saydığından ya da test siparişlerini ayrı tuttuğundan emin olun.

Hazır modüllerde test modu

WHMCS, BILLmanager, WooCommerce, CS-Cart, FOSSBilling, Paymenter ve Remnawave modüllerinde test faturaları oluşturan bir test modu vardır. Test modu açıkken WHMCS'te ödeme düğmesini yalnızca giriş yapmış yöneticiler, WooCommerce'te ödeme yöntemini yalnızca mağaza yöneticileri görür; BILLmanager ve CS-Cart'ta test yöntemini bir test müşterisi veya kullanıcı grubuyla sınırlarsınız. Bir sipariş verin, SnapEX Pay sayfasında ödeyin ve siparişin ödendi durumuna geçtiğini kontrol edin; ardından test modunu kapatın. pay.snapex.pro adresindeki kurulum rehberleri bu adımı her modül için anlatır.

Ardından canlı moda geçin

"environment": "test" alanını kaldırın (ya da modülde test modunu kapatın); sonraki faturalar canlı olur. Test ödemeleri asla canlı siparişlere işlenmez.

Tüm API ayrıntıları: SnapEX Pay API dokümantasyonu.