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-TimestampveX-Signaturebaş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ı istek401dö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/SignatureErroratar. 401yanıtları imzasızdır;403,404,422,429ve500yanı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-card | card.number ve card.security_code istek gövdesinde sunucunuzdan gönderilir. |
create-order, create-subscription, create-payment-link | Kart verisi gönderilmez; ödeme gateway'in ödeme sayfasında alınır. |
retrieve-bin | Yalnı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_tokengönderilir. - SDK'lar kart numarasını ve güvenlik kodunu nesnelerin metin çıktısına yazmaz (PHP
var_dump, Pythonrepr(), JavatoString()).
Adresler
- SDK örneklerindeki
BASE_URLbirhttpsadresidir. callback_url,success_urlvecancel_urlalanları ile panelde tanımlanan webhook adresleri yalnızcahttpsile başlayan, herkese açık adresleri kabul eder;localhost,.localve ö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_urlvecancel_urlalanlarındahttpvelocalhostadresleri de kabul edilir. Webhook adresleri sandbox'ta da herkese açıkhttpsadresi 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ı.