Skip to content

3DS Destekli Sipariş Linki Oluşturma ​

Bu sayfada, Sipariş API kullanılarak 3D Secure doğrulaması ile gerçekleştirilen güvenli ödeme işlemlerinin entegrasyon adımları ve API detayları açıklanmaktadır.

Bu modelde, üye işyeri VPOS sistemine bir sipariş isteği göndererek 3D Secure destekli ödeme linki oluşturur. Müşteri, bu link üzerinden VPOS’un ortak ödeme sayfasına yönlendirilerek işlemi tamamlar.

İşleyiş ​

  1. Sipariş İsteği Gönderimi: Üye işyeri, createOrder3DS servisi aracılığıyla işlem bilgilerini içeren bir sipariş isteği gönderir (orderType: "L").
  2. Ödeme Linki Üretimi: VPOS, bu isteğe karşılık olarak özel bir ödeme linki üretir.
  3. Linkin İletilmesi: Üye işyeri, bu linki kendi web sitesine entegre edebilir veya doğrudan müşterisine (SMS, e-posta vb.) iletebilir.
  4. Yönlendirme: Müşteri, linke tıklayarak VPOS’un ortak ödeme sayfasına yönlendirilir.
  5. Kart Girişi & 3DS Doğrulama: Sayfada kart bilgilerini girer ve 3DS doğrulama süreci başlatılır (challenge veya frictionless).
  6. Yetkilendirme Akışı (İşlem Türüne Göre):
    • requestType: "3DS-PAY" ile başlatılan işlemlerde: Doğrulama başarılı olduğunda VPOS sistemi otomatik olarak issuer bankaya finansal yetkilendirme (authorization) isteği gönderir ve provizyon alır. Üye işyeri tarafından ek bir işlem yapılmasına gerek yoktur.
    • requestType: "3DS-MODEL" ile başlatılan işlemlerde: Doğrulama tamamlandıktan sonra üye işyerinin ayrıca Complete3DSPayment isteğini çağırması gerekir. Finansal yetkilendirme ve provizyon bu çağrı ile başlatılır.
  7. Bildirim: İşlem tamamlandığında, returnUrl ve/veya Callback URL üzerinden üye işyerine bildirim yapılabilir (opsiyonel).

Desteklenen İşlem Türleri ​

  • Satış (Sale) ve Ön Provizyon (Pre-Sale) işlemleri desteklenmektedir.
  • İşlemler peşin veya taksitli olarak gerçekleştirilebilir.
  • Üye işyeri yetkisine bağlı olarak dövizli işlemler de yapılabilir.

Kullanım Senaryoları ​

  • Web sitesi üzerinden doğrudan ödeme alma.
  • 3DS doğrulaması zorunlu olan işlemler.
  • Üye işyerinin kendi ödeme formu geliştirmek istemediği durumlar.
  • Müşteriye e-posta, SMS veya uygulama üzerinden ödeme linki gönderme.

Avantajlar ​

  • Güvenli Ödeme: 3DS doğrulama ile dolandırıcılık ve itiraz riski azalır.
  • Hızlı Entegrasyon: Üye işyeri, karmaşık ödeme altyapısı geliştirmeden işlem alabilir.
  • Esnek Dağıtım: Link ile ödeme başlatılabilir; web, mobil veya mesajlaşma kanalları üzerinden iletilebilir.
  • Kolay Takip: returnUrl ve Callback URL ile işlem durumu izlenebilir.

Kullanım Notları ​

Önemli: Kullanım yetkisi VPOS sistemi tarafından tanımlanır; bu hizmetler tüm üye işyerleri için otomatik olarak aktif değildir.

  • Ödeme linkleri süreli ve tek kullanımlıktır; geçerlilik süresi entegrasyon aşamasında tanımlanmalıdır.
  • orderId her işlem için benzersiz olmalıdır.
  • returnUrl ve Callback URL doğru yapılandırılmalıdır.