Ana içeriğe geç

Güvenlik

Kimlik bilgileri​

  • Gizli anahtar hiçbir istekte gönderilmez; yalnızca imza üretmek ve doğrulamak için kullanılır. Tarayıcıda ya da mobil uygulamada çalışan koda koymayın.
  • Anahtar çifti Entegrasyon sayfasından yenilenebilir. Yenileme anında eski çift geçersiz olur.
  • API anahtarı yalnızca kendi çalışma alanının adresinde geçerlidir.

İstek ve yanıt imzası​

  • Her istek X-Timestamp ve X-Signature başlıklarıyla imzalanır. İmza zaman damgasını, metodu, yolu ve gövdeyi kapsar: bir uç için imzalanmış istek başka bir uca gönderilemez, 5 dakikadan eski zaman damgası kabul edilmez. İmzasız ya da hatalı imzalı istek 401 döner ve işlenmez.
  • Gateway yanıtları aynı gizli anahtarla, aynı yöntemle imzalanır. İmzası doğrulanmayan bir yanıtı işlemeyin. SDK'lar bunu otomatik yapar ve imza tutmazsa SignatureException / SignatureError atar.
  • 401 yanıtları imzasızdır; 403, 404, 422, 429 ve 500 yanıtları (çalışma alanı bulunduğunda) imzalıdır. İmza, bir hata yanıtını başarılı sonuca çevirmez.

Yöntem ve örnekler: Kimlik Doğrulama ve İmza.

Webhook imzası​

Webhook'lar API yanıtlarıyla aynı yöntemle (X-Timestamp + X-Signature) imzalanır. Gövdeyi ham hâliyle doğrulayın; imza tutmayan bildirimi işlemeyin. İmza tutsa bile webhook gövdesi nihai sonuç değildir: yalnızca token taşır, kararı retrieve-* yanıtına göre verin. Bkz. Webhook.

Dönüş POST'u​

callback_url / success_url adresine gelen form müşterinin tarayıcısından gelir ve imzasızdır. Ödeme sonucu olarak yalnızca imzalı retrieve-payments ya da retrieve-orders / retrieve-subscriptions yanıtını kullanın. Bkz. Dönüş POST'u.

Kart verisi​

UçKart verisi
secure-payment, regular-payment, create-saved-cardcard.number ve card.security_code istek gövdesinde sunucunuzdan gönderilir.
create-order, create-subscription, create-payment-linkKart verisi gönderilmez; ödeme gateway'in ödeme sayfasında alınır.
retrieve-binYalnızca kart numarasının ilk 6–8 hanesi gönderilir.
  • Gateway yanıtlarında kart numarasının yalnızca ilk 6–8 hanesi (first_digits) ve son 4 hanesi (last_four_digit) döner; tam numara ve güvenlik kodu hiçbir yanıtta dönmez.
  • Kayıtlı kartla ödemede kart verisi yerine saved_card_token gönderilir.
  • SDK'lar kart numarasını ve güvenlik kodunu nesnelerin metin çıktısına yazmaz (PHP var_dump, Python repr(), Java toString()).

Adresler​

  • SDK örneklerindeki BASE_URL bir https adresidir.
  • callback_url, success_url ve cancel_url alanları ile panelde tanımlanan webhook adresleri yalnızca https ile başlayan, herkese açık adresleri kabul eder; localhost, .local ve özel ağ adresleri reddedilir: Adres herkese açık bir adres olmalı.
  • Tek istisna sandbox: entegrasyonu kendi bilgisayarınızda deneyebilmeniz için orada callback_url, success_url ve cancel_url alanlarında http ve localhost adresleri de kabul edilir. Webhook adresleri sandbox'ta da herkese açık https adresi olmalıdır.

İstek sınırları​

Gateway istekleri çalışma alanı başına dakikada 300, ödeme, iade ve kart işlemlerinde dakikada 60 ile sınırlıdır. Bkz. İstek Sınırları.