DurumEN
BaşlarkenPayment OrchestratorCüzdanBanka HesaplarıSigortaFraud & Fraud AIIdentitySanctionAutomationSDKDemo
Payment Orchestrator
Payment
Kredi/Banka Kartı

Kart

Kartla ödemeyi kendi sunucunuzdan POST /payments/direct/payment ile paymentMethod: "CARD" göndererek başlatırsınız. Bu uç, cüzdan ve Faturana Yansıt ile aynı istek ve yanıt biçimini kullanır. Bu sayfa 2D ile 3D Secure arasındaki seçimi ve bütün kart ödemeleri için geçerli kuralları anlatır; istek alanları, örnekler ve hatalar Kart — 2D ve Kart — 3D Secure sayfalarındadır.

Checkout Formu kullanıyorsanız kart çekimini form yapar → 2D Form · 3D Form.

⚠️

PCI DSS gerektirir. Ham kart numarasını (PAN) sunucunuzda alıp gönderdiğiniz için sistemleriniz PCI DSS kapsamına (SAQ D) girer. Kart verisi işlemek için sertifikalı değilseniz Checkout Formu kullanın. Daha önce kaydedilmiş bir kartı çekmek için PAN gerekmez; bkz. Kayıtlı kart.

2D mi 3D Secure mi

2D3D Secure
İstekforce3D yok ya da falseforce3D: true
Banka doğrulamasıYokAlıcı işlemi bankasıyla onaylar (SMS kodu, banka uygulaması, biyometri)
Alıcının yönlendirilmesiYok; sonuç aynı yanıtta dönerYanıt REDIRECT aksiyonu taşır; alıcının tarayıcısı banka sayfasına gider ve callbackUrl adresinize döner
Sorumluluk devri (liability shift)Yok; kendi risk kontrollerinizle kullanınVar
Kart kaydıYapılamazÖdeme sırasında yapılır
Uygun olduğu akışlarKayıtlı kartla tekrar çekim, sunucu tarafı tahsilat, yönlendirmenin mümkün olmadığı akışlarAlıcı ekran başındayken alınan ödemeler, kart kaydı
SayfaKart — 2DKart — 3D Secure
  • force3D yalnız paymentMethod: "CARD" ile gönderilir ve boolean olmalıdır; "true" gibi metin değer 400 VALIDATION_ERROR alır.
  • 3D Secure kararı sizin force3D seçiminizdir. Checkout Formu için tanımlanan 3D ayarları (intent'teki force3D, settings.threeD ve panel 3D politikası) sunucudan başlatılan kart ödemelerine uygulanmaz.
  • 2D istenen bir ödemeyi risk değerlendirmesi ya da hesabınıza tanımlı bir limit kuralı 3D Secure'a çevirebilir; bkz. Kart — 2D › 3D'ye dönüş.

Kayıtlı kart

  • Kaydetme: Kart yalnız 3D Secure ile yapılan bir ödeme sırasında kaydedilir; ayrı bir "kartı kaydet" çağrısı yoktur. force3D: true ile birlikte customerId ve card.cardSave: true gönderin. 2D istekte cardSave: true ödeme başlamadan 400 payment.card.save_requires_3ds alır. Ayrıntı: Kart — 3D Secure › Kartı kaydetme.
  • Çekme: Ayrı bir kayıtlı kart ucu yoktur. card nesnesine ham kart alanları yerine cardUserKey ve cardToken koyun; 2D ve 3D Secure isteklerinde aynıdır.
  • cardToken, kart kaydedildiğinde dönen kalıcı referanstır (storedCardToken). Checkout Formu'nun tek kullanımlık kart token'ı kullanılamaz.
  • Kart saklamanın açılması ve kartların listelenmesi: Kart Saklama.

Ortak kart kuralları

  • Tutar: Bütün tutarlar minor unit (kuruş) cinsinden tam sayıdır: "amount": 10050 = ₺100,50. Tutar yalnız amount ile gönderilir ve sepet toplamıdır.
  • Kart alanları: card, force3D, installment ve installmentQuoteToken yalnız paymentMethod: "CARD" ile gönderilebilir.
  • Taksit: installment 2 ve üzeriyse taksit quote'undan alınan installmentQuoteToken zorunludur. Vade farkını sistem quote'tan hesaplar ve çekilen tutara ekler: çekilen tutar = amount + vade farkı.
  • Sağlayıcı: Kartta sağlayıcıyı yönlendirme seçer; kart bloğunda providerCode yoktur. Yöntem listesinde kart satırı providerSelectionMode: "PLATFORM" ve providerSelection: "ROUTED" taşır; bkz. Yöntemleri Listeleme.
  • Idempotency: Idempotency-Key zorunludur; reddedilen bir siparişi yeniden denemek için yeni anahtar gönderin.
  • Ön provizyon: "preauth": true ile tutar bloke edilir ve ödeme AUTHORIZED olur. Talimat hiçbir koşulda anında çekime dönüştürülmez; bkz. Ön Provizyon, Capture & İptal.
  • Kesin sonuç: Siparişi payment.captured webhook'u ya da GET /payments/:id teyidiyle teslim edin. 202 yanıtında yeni bir çekim açmayın.

Uç, kimlik doğrulama, aksiyonlar ve ortak hata kodları: Payment.

Sayfalar

Kart — 2D→Kart — 3D Secure→
Yöntemleri Listeleme2D