İçeriğe atlayın

Başlangıç

Bu sayfada

Test

Özel test anahtarları, imzalı webhook'lar ve gerçek para hareket ettirmeyen simülasyon uçlarıyla fatura ve çekim durum değişikliklerini test edin.

Entegrasyonunuzu sandbox'ta uçtan uca test edin. Üretimle aynı API yüzeyi, simüle edilmiş blockchain, imzalı webhook'lar; risk altında gerçek para yok.

Sandbox ve üretim

Özellik Sandbox Üretim
Temel URL api.paymos.io/v1 api.paymos.io/v1
API Anahtarları pk_test_ / rk_test_ kimlikleri ve sk_test_ sırları pk_live_ / rk_live_ kimlikleri ve sk_live_ sırları
İşlemler Simüle edilmiş Gerçek blockchain
Webhook'lar Normal gönderilir Normal gönderilir
Fonlar Gerçek değer yok Gerçek kripto

Ödemeleri simüle etme

Sandbox ödemeleri bir zamanlayıcıyla otomatik onaylanmaz. Açıkça tetikleyin:

POST/v1/sandbox/invoices/:invoice_id/simulate-payment

Gövde: { "stage": "paid" } — stage değeri paid, overpaid, underpay veya cancel'dan biridir. Diğer imzalı /v1 çağrıları gibi kimliğini doğrulayın; yalnızca sandbox faturaları üzerinde çalışır, bu yüzden üretim anahtarı 403 not_sandbox ile reddedilir. Gerçek bir zincir üstü ödemeyle aynı yaşam döngüsü ve webhook olaylarını tetikler; böylece doğrulama yolunuz sandbox ve üretim arasında aynı kalır.

Çekimleri simüle etme

Sandbox çekimleri gerçek bir zincirde sonuçlanmaz. Bekleyen bir sandbox çekimini tamamlanmış işaretleyerek tüm ödeme çıkış akışınızı çalıştırın:

POST/v1/sandbox/withdrawals/:withdrawal_id/simulate-completion

İstek gövdesi yoktur. Diğer /v1 çağrıları gibi Payout anahtarınızla kimliğini doğrulayın; yalnızca sandbox çekimleri üzerinde çalışır. Çekimi completed durumuna geçirir ve gerçek bir zincir üstü ödeme çıkışıyla aynı withdrawal.completed webhook'unu yayar; böylece mutabakat yolunuz sandbox ve üretim arasında aynı kalır.

Kanal yatırmalarını simüle etme

Sandbox ödeme kanalları adreslerini yerelde türetir ve hiçbir zinciri izlemez; yatırmalar bu yüzden açıkça oluşturulur:

POST/v1/sandbox/payment-channels/:payment_channel_id/simulate-deposit

Gövde: { "amount": "100", "currency": "USDT", "network": "TRC20", "stage": "confirmed" } — stage değeri confirming, reorged veya confirmed olur; belirtilmezse confirmed. Sandbox Payment anahtarınızla imzalayın; üretim anahtarı, ortada bir şey oluşmadan reddedilir. Her çağrı önce payment_channel.deposit.confirming yayar; ardından hangi olayın geleceğine istediğiniz aşama karar verir. Böylece webhook yolunuz sandbox ve üretim arasında aynı kalır. Sözleşmenin tamamı için bkz. Kanal Yatırması Simüle Et.

Webhook'ları yerelde test etme

Yerel sunucunuzu bir tünel üzerinden açın:

ngrok http 3000

Webhook URL'sini Panel → Geliştirici → Webhook'lar bölümünde ayarlayın:

https://abc123.ngrok.io/api/paymos-webhook

Webhook playground

Dokümantasyon, yalnızca sandbox'ta çalışan bir Webhook Playground içerir — kayıtlı URL'nize tam imzalı bir olay teslim eder; fatura oluşturmadan imza işlemenizi doğrulamak için kullanışlıdır.

  • 01Sandbox ortamında Panel → Geliştirici → Dokümantasyon bölümüne gidin
  • 02Webhook'lar → Test sayfasını açın, sonra Playground seçin
  • 03Olay Türü listesinden bir senaryo seçin (invoice.paid, invoice.paid_over, invoice.underpaid veya invoice.cancelled), tutar ile para birimini girin ve Simüle et'e basın
  • 04Sunucu günlüklerinizde alınan olayı ve X-Webhook-Signature başlığını kontrol edin

Yayına geçmeden önce kontrol listesi

  • ☐Webhook imza doğrulaması çalışıyor
  • ☐Fatura oluşturma doğru veri döndürüyor
  • ☐Ödeme akışı doğru yönlendiriyor
  • ☐Hata işleme 2xx dışı yanıtları kapsıyor (4xx doğrulama, 409 çakışmalar)
  • ☐external_order_id ile idempotency çalışıyor
  • ☐API anahtar kimliklerini pk_test_ / rk_test_ yerine pk_live_ / rk_live_ olarak, sırları sk_test_ yerine sk_live_ olarak değiştirin
Ödeme Akışı Kimlik Doğrulama