İçeriğe atlayın

API

Bu sayfada

Test

Etkileşimli dokümantasyon playground'undan gerçek sandbox fatura ve webhook teslimat yolunu çalıştırın.

Playground sekmesi gerçek Sandbox yolunu çalıştırır. Merchant API üzerinden bir fatura oluşturur, ödeme seçimini onaylar, seçilen sandbox sonucunu tetikler ve teslimat işçisinin etkin uç noktanızı çağırmasını bekler.

URL'nize doğrudan uydurma bir olay POST etmez. Olay; normal Sandbox işlemlerinin kullandığı aynı outbox, imzalama, zaman aşımı, yeniden deneme ve teslimat kodu tarafından işlenir.

Ön koşullar

  • Panel'i Sandbox'a geçirin.
  • En az bir etkin test token'ı olan bir proje seçin.
  • Etkin bir Sandbox Payment API anahtarı oluşturun.
  • Etkin bir Sandbox webhook uç noktası kaydedin.
  • HTTPS uç noktasını herkese açık internetten erişilebilir yapın.

Playground'da üretim gönderimi bilinçli olarak kapalıdır.

Kullanılabilir senaryolar

Senaryo Sonuçta oluşan olay
Tam ödeme invoice.paid
Fazla ödeme invoice.paid_over
Nihai eksik ödeme invoice.underpaid
İptal invoice.cancelled

Panel → Geliştirici → Dokümantasyon bölümünü açın: aynı sayfa, ama orada Playground sekmesi kılavuzun üstünde yer alır. Olay türünü, tutarı ve para birimini seçin, sonra Simüle et düğmesine tıklayın. Yanıt paneli son Merchant API çağrısını gösterir. Teslimat durumu, Paymos webhook denemesini gözlemledikten sonra görünür.

Bir testte tanılama

Olayı ve her teslimat denemesini incelemek için Panel → Geliştirici → Webhook'lar bölümünü açın. Önce şu değerleri karşılaştırın:

  1. X-Webhook-Id ile yükteki event_id.
  2. Alınan ham gövde ile doğrulayıcınıza verilen baytlar.
  3. Uç noktanın yanıt durumu ve yanıt süresi ile teslimat politikası.
  4. Uç noktanın Sandbox sırrı ile sunucunuzun kullandığı sır.

Başarısız bir alıcıyı düzelttikten sonra olayı ayrıntı görünümünden tekrar gönderin. Tekrar gönderme aynı olay kimliğini korur; böylece idempotency korumanız geçerli kalır.