3D Ödeme Servisi İşlem Akışı
🚀 Deneyimli Geliştiriciler İçin Hızlı Geçiş
3D ödeme sürecine zaten hakimseniz ve detaylı açıklamalara ihtiyaç duymuyorsanız, doğrudan 3D Ödeme sayfasına geçebilirsiniz.
Aşağıdaki görselde 3D ödeme entegrasyonunun temel adımlarını ve sistemler arası veri akışını özetledik. Her adımda ne yapılması gerektiği kutucuklarda açıklanmıştır.
1
Kullanıcıdan Ödeme Bilgileri Alınır
Kullanıcı kart, sepet, tutar ve taksit bilgilerini doldurur; bu bilgiler, ödeme sonrası dönülecek returnUrl ile birlikte /external/vpos/v1/payments endpoint'ine kendi sunucunuzdan gönderilir.
POST /external/vpos/v1/payments
{ ... kart, tutar, taksit, returnUrl ... }
{ ... kart, tutar, taksit, returnUrl ... }
↓
2
TahsilatE İsteği Değerlendirir
TahsilatE, gelen parametreleri kontrol eder, güvenlik ve doğrulama işlemlerini yapar.
Kontroller: istek imzası, kart, tutar, taksit, sepet toplamı ve transactionId'nin daha önce kullanılmamış olması.
Test: Test ortamı, Başlangıç sayfasındaki test Base URL'i ile seçilir.
Test: Test ortamı, Başlangıç sayfasındaki test Base URL'i ile seçilir.
↓
3
3D Yönlendirme Bilgisi Döner
Başarılı ise, form veya url ile 3D doğrulama için yönlendirme bilgisi döner. threeD.type: 'form' | 'url'
Cevap (content.threeD):
{ type: 'form', form: '<form ...>' }
veya
{ type: 'url', url: 'https://3d-page' }
Banka ödemeyi başlatmazsa HTTP 422 döner; kullanıcıyı yönlendirmeyin, mesajı gösterin.
{ type: 'form', form: '<form ...>' }
veya
{ type: 'url', url: 'https://3d-page' }
Banka ödemeyi başlatmazsa HTTP 422 döner; kullanıcıyı yönlendirmeyin, mesajı gösterin.
↓
4
Kullanıcı 3D Doğrulama Ekranına Yönlendirilir
Üye işyeri, cevaptaki threeD.type değerine göre kullanıcıyı 3D doğrulama ekranına yönlendirir.
- type: 'form' ise, dönen form HTML'i doğrudan DOM'da yer alıyorsa içindeki <script> ile otomatik submit edilir. Ancak form HTML'i client tarafında sonradan DOM'a inject edilirse, submit işlemini manuel olarak tetiklemeniz gerekebilir.
- type: 'url' ise, kullanıcıyı manuel olarak ilgili url'e yönlendirmeniz gerekir.
Örnek:
// type: 'form' için
<form ...>
...
<script>document.forms[0].submit()</script>
</form>
// Eğer form sonradan DOM'a eklendiyse:
document.forms[0].submit();// type: 'url' için
// Kullanıcıyı manuel olarak ilgili url'e yönlendirin
// type: 'form' için
<form ...>
...
<script>document.forms[0].submit()</script>
</form>
// Eğer form sonradan DOM'a eklendiyse:
document.forms[0].submit();// type: 'url' için
// Kullanıcıyı manuel olarak ilgili url'e yönlendirin
↓
5
Kullanıcı returnUrl'e Yönlendirilir
TahsilatE, 3D doğrulama işlemini sonuçlandırır ve kullanıcının tarayıcısını üye işyerinin returnUrl adresine yönlendirir (GET). Sonuç, query string parametreleri olarak gelir.
GET returnUrl?status, transactionId, message, amount, installment, rnd, signature
Bu parametreler kullanıcının tarayıcısından gelir ve değiştirilebilir. signature değerini mutlaka doğrulayın; ayrıntılar Sonuç Doğrulama sayfasında.
↓
6
Ödeme Sonuç Kontrolü ile Doğrulama
İmza doğrulandıktan sonra siparişi kesinleştirmeden önce İşlem Sorgulama servisiyle ödemenin durumunu sunucunuzdan sorgulayın. Kullanıcı tarayıcıyı returnUrl'e ulaşmadan kapatabileceği için sonucu ayrıca webhook ile de almanız önerilir.
Örnek:
GET /external/vpos/v1/payments/{transactionId}
GET /external/vpos/v1/payments/{transactionId}
Ödeme sonuç kontrolü işlemini kesinlikle server to server olarak yapmanız gerekmektedir.
