DOCS
Panel Giriş Başvurun

API (3D · NON3D)

3DS

3D Secure: kart sahibinin kendi bankası tarafından doğrulandığı güvenli ödeme akışı — başlatmadan tamamlamaya.

Neden 3DS?

  • Doğrulama bankada yapıldığı için ters ibraz sorumluluğu bankaya geçer.
  • Sahtecilik riski belirgin şekilde azalır.
  • Bazı kartlar ve bankalar 3D doğrulamayı zorunlu tutar.

Akış

Müşteri (Tarayıcı)SunucunuzPaynkolayBanka (3D)Kart bilgileri + ödeme isteği1POST /Vpos/v1/Paymentuse3D=true · hashDatav223D doğrulama formu (HTML)3Formu tarayıcıya bas4SMS / OTP onayı5Doğrulama sonucu6Sonuç successUrl / failUrl'e POST7hashDataV2 + Altın Kural(RESPONSE_CODE=2, AUTH_CODE)8Sonuç sayfası9

2 aşamalı moddaysanız 7. adımdan sonra ödemeyi CompletePayment ile siz tamamlarsınız.

  1. 1Ödeme isteği/Vpos/v1/Payment ucuna use3D=true ile istek gönderilir.
  2. 2Banka doğrulamasıMüşteri, bankasının 3D Secure sayfasına yönlendirilir ve SMS/şifre ile doğrulanır.
  3. 3Sonuç dönüşüİmzalı sonuç successUrl / failUrl adresinize POST edilir; hash doğrulanır.
  4. 4Tamamlama (2 aşamalıysa)AUTOCOMPLETE kapalıysa CompletePayment çağrısıyla provizyon alınır.

Tek Aşamalı mı, 2 Aşamalı mı?

Tek Aşamalı
  • Doğrulama sonrası provizyon otomatik alınır
  • Ek çağrı gerekmez — en yaygın kullanım
2 Aşamalı (AUTOCOMPLETE=false)
  • Doğrulama sonrası durum: TAMAMLANMAMIŞ İŞLEM
  • Provizyon, CompletePayment çağrısıyla sizin kontrolünüzde alınır

Adımlar

Son güncelleme: 11 Eylül 2026

v1 · Versiyonlar