3D Secure Başlatma
Bu endpoint, kullanıcıyı bankanın 3D Secure doğrulama sayfasına yönlendirmek için gerekli HTML içeriğini döndürür.
Dönen htmlContent değeri kullanıcının tarayıcısında render edilerek banka doğrulama ekranı görüntülenir.
Bu endpoint HTTP Form POST (multipart/form-data) yöntemiyle çalışır. Kimlik doğrulama bilgileri header yerine form field olarak gönderilir.
Ön Koşullar
Bu endpoint'i çağırmadan önce aşağıdaki adımların tamamlanmış olması gerekir:
-
Kimlik doğrulama değerlerini hazırlayın —
PublicKey,Nonce,SignatureveConversationIddeğerlerini oluşturun. Test ortamında Test İmzası Oluştur endpoint'ini kullanabilirsiniz. -
Kart tokenize edin — /v1/Tokens endpoint'inden
cardTokendeğerini alın. -
3D Secure oturumu oluşturun — /v1/ThreeDS/getthreedsession endpoint'inden
threeDSessionIddeğerini alın.
Akış
İsteği Gönderin
threeDSessionId, callbackUrl ve kimlik doğrulama bilgilerini form field olarak gönderin.
POST /v1/ThreeDS/init3ds
Content-Type: multipart/form-data
ThreeDSessionId=3ds_session_abc123
CallbackUrl=https://yoursite.com/3ds-callback
LanguageCode=tr
ClientIpAddress=192.168.1.1
CardHolderName=John Doe
PublicKey=your-public-key
Nonce=1770629965755
Signature=dZspDJX18zdC1MnX4d0mhIX0F3IitK0+DQb5ZyxqR3U=
ConversationId=conv-001
MerchantNumber=000001HTML İçeriğini Render Edin
Başarılı yanıtta dönen htmlContent değerini kullanıcının tarayıcısında render edin. Bu içerik, kullanıcıyı bankanın 3D Secure doğrulama sayfasına yönlendirir.
{
"isSucceed": true,
"errorCode": null,
"errorMessage": null,
"conversationId": "conv-001",
"htmlContent": "<html><!-- Banka 3DS sayfası... --></html>"
}htmlContent genellikle bir auto-submit form veya iframe redirect içerir. Bu HTML'i doğrudan bir iframe veya yeni sayfa içinde render etmeniz yeterlidir.
Callback'i Bekleyin
Kullanıcı bankadaki doğrulamayı tamamladığında (veya iptal ettiğinde), tarayıcı belirttiğiniz CallbackUrl adresine yönlendirilir.
Callback sonrası 3D Secure Sonuç Sorgulama endpoint'i ile doğrulama sonucunu kontrol edin.
API Playground
Request Body
multipart/form-data
Response Body
application/json
curl -X POST "https://testpfapi.rubikpara.com/v1/ThreeDS/init3ds"{
"conversationId": "test123456"
}