Panelde istek kayıtları ve olaylar

Bir entegrasyon beklenmedik davrandığında, üye işyeri paneli sunucularınıza erişmeden gerçekte ne olduğunu gösterir. Hepsi Geliştiriciler altındadır.

İstek kayıtları (request logs)

Geliştiriciler → İstek kayıtları, kendi /v1 API isteklerinizi en yeniden eskiye doğru listeler: zaman, yöntem ve yol, HTTP durumu, çağrıyı yapan API anahtarı veya kullanıcı, gecikme ve okunan ya da değiştirilen nesne.

Ayrıntıları görmek için bir isteği açın: istek ve yanıt gövdeleri, hata (type, code, decline_code, param), Idempotency-Key ve yanıtın tekrar oynatılıp oynatılmadığı, API sürümünüz, kaynak IP ve user agent ile varsa uyarılar (sandbox'ta yalnızca uyarı verilen bir kural; örneğin ip_not_allowed veya eksik bir geri dönüş adresi kaydı).

Bir isteği bulmak için yanıt başlığındaki Request-Id (req_…) veya bir hatadaki request_id, nesne kimliği (örneğin pi_…), durum (402, 4xx, failed), yöntem, yol öneki, API anahtarı ya da zaman aralığı kullanılabilir.
Gövdeler maskelenir. Kart numaraları ilk 6 ve son 4 haneye kısaltılır, CVC ve son kullanma tarihi kaldırılır, gizli bilgiler, parolalar, token'lar ve yetkilendirme verileri değiştirilir, IBAN'lar maskelenir. Müşteri iletişim verileri maskelenir. 32 KB'tan uzun gövdeler kesilir ve bu şekilde işaretlenir.
Yalnızca hesabınız olarak kimlik doğrulayan istekler kaydedilir. Hatalı anahtarla yapılan istek size atfedilemez ve saklanmaz.
Kayıtlar sınırlı bir süre saklanır (varsayılan olarak 30 gün).

Aynı veriye gizli anahtarla veya request_logs:read kapsamına sahip kısıtlı bir anahtarla GET /v1/request_logs ve GET /v1/request_logs/{id} üzerinden de erişilebilir.

curl -G https://pay.example.com/v1/request_logs \
  -H "Authorization: Bearer sk_sandbox_YOUR_KEY" \
  --data-urlencode "status=402" \
  --data-urlencode "path=/v1/payment_intents" \
  --data-urlencode "limit=20"

Olaylar ve webhook teslimatları

Geliştiriciler → Olaylar, hesabınızın ürettiği her olayı (payment_intent.succeeded, refund.failed, …) içeriğiyle ve her webhook uç noktanız için teslimatlarla birlikte listeler: her deneme HTTP durumu, gecikme ve yanıtınızdan maskelenmiş bir alıntıyla gösterilir. Olay başına bir teslimat sayacı, olayın size ulaşıp ulaşmadığını bir bakışta gösterir.

Bir olayı, örneğin işleyicinizdeki bir hatayı düzelttikten sonra, uç noktanıza yeniden göndertebilirsiniz. Geliştiriciler → Webhook'lar, her uç noktayı son 24 saat ve 7 gündeki başarı oranı, durumu (enabled, disabled veya failing) ve imzalama gizli anahtarını yenileme eylemiyle birlikte gösterir. Webhook kılavuzu yeniden denemeleri ve başarısız bir uç noktanın nasıl yeniden etkinleştirileceğini açıklar.

Geliştiriciler altındaki diğer bölümler

API anahtarları: anahtar oluşturun, kısıtlayın ve iptal edin; her birinin en son ne zaman kullanıldığını görün.
Ayarlar → İzinli IP adresleri ve Ayarlar → Web siteleri ve geri dönüş adresleri: kimlik doğrulama kılavuzunda anlatılan kayıtlar. Bunların uyarıları ve retleri istek kayıtlarında görünür.

Kim neyi görebilir

İstek kayıtları ve olaylar panelde developers.view iznini (sahip, yönetici ve geliştirici rolleri) gerektirir. Üretim istek kayıtlarını bu rollerin arkasında tutun: maskelenmiş olsalar bile müşterilerinizin ödemelerini anlatırlar.

Hata ayıklama rutini

Aldığınız hatadan (veya kendi kayıtlarınızdan) request_id değerini alın.
İstek kayıtları bölümünde açın ve istek gövdesini göndermek istediğinizle karşılaştırın.
Uyarıları kontrol edin: sandbox'ta yalnızca uyarı olan bir kural canlıda ret olacaktır.
Eksik bildirimler için olayı Olaylar bölümünde açın ve teslimat denemelerini okuyun.
Hâlâ çözemediniz mi? request_id değerini destek ekibine gönderin; aynı kaydı bulabilirler.