3D Secure Oturum Oluştur

Genel Bakış

3D Secure ödeme akışını başlatmak için gerekli olan oturumu (session) oluşturur. Bu adımda kart bilgileri ve işlem tutarı ile bir oturum ID'si alınır.

Ön Koşullar

Bu endpoint, 3D Secure ödeme akışının ilk adımıdır. Çağırmadan önce aşağıdaki ön koşulların tamamlanmış olması gerekir:

Kimlik doğrulama değerlerini hazırlayın — Header'da gönderilecek PublicKey, Nonce, Signature ve ConversationId değerlerini oluşturun.
Kart tokenize edin — /v1/Tokens endpoint'inden dönen cardToken değerini bu isteğin body'sindeki cardToken alanına yazın.

API Playground

Header Parameters

PublicKey?string

Nonce?string

Signature?string

ConversationId?string

ClientIpAddress?string

İşlem yapan kullanıcının IP adresi (örn: 192.168.1.1)

MerchantNumber?string

X-Forwarded-For?string

Request Body

application/json

Kart token ve ödeme bilgileri. cardToken değerini /v1/Tokens endpoint'inden alın.

amount?number

Toplam ödeme tutarı

Formatdouble

pointAmount?number

Puan ile ödenecek tutar. Puan kullanılmayacaksa 0 gönderin.

Formatdouble

cardToken?|

/v1/Tokens endpoint'inden dönen cardToken değeri

currency?|

Para birimi (ISO 4217)

paymentType?string

Ödeme tipi: Auth (direkt çekim), PreAuth (ön otorizasyon), PostAuth (ön otorizasyon kapama)

Value in"Auth" | "PreAuth" | "PostAuth"

installmentCount?integer

Taksit sayısı. Tek çekim için 1 gönderin.

Formatint32

languageCode?|

Dil kodu (tr, en vb.)

[key: string]?never

Response Body

`application/json`

curl -X POST "https://testpfapi.rubikpara.com/v1/ThreeDS/getthreedsession" \  -H "PublicKey: Xu3aI6WHR6geG/I/swR0Lg==" \  -H "Nonce: " \  -H "Signature: " \  -H "ConversationId: test123456" \  -H "ClientIpAddress: 192.168.1.1" \  -H "MerchantNumber: 1100000001" \  -H "Content-Type: application/json" \  -d '{    "amount": 100,    "pointAmount": 0,    "cardToken": "w2maVeYtMJeQ8lMeB0RLbzZuHt+H5OWGywvTRphsu5k=",    "currency": "TRY",    "paymentType": "Auth",    "installmentCount": 1,    "languageCode": "tr"  }'

{
  "threeDSessionId": "3ds_session_abc123",
  "isSucceed": true,
  "errorCode": null,
  "errorMessage": null,
  "conversationId": "test123456"
}