For the complete documentation index, see llms.txt. This page is also available as Markdown.

3D Ödeme Başlat

3D Ödeme Başlatma adımı, kartlı bir ödemenin 3D Güvenli doğrulama sürecine sokulmasını sağlar.

Bu çağrı sonucunda API tarafından bankaya yönlendirme için gerekli olan Base64 encoded 3D içerik döner. Üye işyeri bu içeriği decode ederek son kullanıcıyı bankanın 3D Güvenli doğrulama ekranına yönlendirmelidir.

⚠️ Bu adımda ödeme henüz tamamlanmaz. Kullanıcının bankadaki doğrulama işlemini tamamlamasından sonra 3D Ödeme Tamamlama (Auth3d) adımı çağrılmalıdır.


Endpoint

POST /v1/Payment/Init3d

Headers

Anahtar
Tür
Açıklama
Örnek

x-ClientID

String

API istemcisi için benzersiz tanımlayıcı

sizin-istemci-id'niz

x-ClientSecret

String

API istemcisi için gizli anahtar

sizin-gizli-anahtarınız

x-GrantType

String

Kullanılan erişim tokeni türü

istemci_kimlik_bilgileri

x-Scope

String

API kapsamı

pf_write, pf_read

x-Timestamp

String

İstek zaman damgası

2024-12-17T12:34:56Z


Request Body

Alan
Zorunlu
Tür
Açıklama
Örnek

merchantId

✅

Integer

Üye işyeri için benzersiz kimlik

100000000000004

returnUrl

✅

String (URL)

Başarılı doğrulama sonrası yönlendirme URL

https://www.ornek.com/basari

failUrl

✅

String (URL)

Başarısız doğrulama sonrası yönlendirme URL

https://www.ornek.com/hata

paymentMethod

✅

String

Ödeme yöntemi

CARDPAYMENT

language

✅

String

İşlem dili

tr

conversationId

✅

String

İşlem takip numarası

MSD2024030500000000115

sign

✅

String

İsteğin doğrulanması için dijital imza

AAVWY3RZKJVVCEAD8LDQB4K

paymentInstrumentType

✅

String

Ödeme aracı türü

CARD

cardDetails.cardNo

✅

String

Kart numarası

4508034508034581

cardDetails.expDate

✅

String

Son kullanma tarihi (AAYY)

1226

cardDetails.cvv

✅

String

Kart güvenlik kodu

000

transactionDetails.transactionType

✅

String

İşlem türü

SALE

transactionDetails.installmentCount

✅

Integer

Taksit sayısı

1

transactionDetails.amount

✅

Float

İşlem tutarı

60.00

transactionDetails.currencyCode

✅

Integer

Para birimi kodu (ISO 4217)

949

transactionDetails.vftFlag

❌

Boolean

VFT’nin etkin olup olmadığını gösterir

false

cardHolderInfo.cardHolderName

✅

String

Kart sahibinin adı

Selim Dil

cardHolderInfo.buyerGsm

✅

String

Alıcının GSM numarası

55555555

extraParameter.pfSubMerchantId

❌

String

Alt üye işyeri kimliği

12345

Response Body

Bu servis Base64 encoded 3D içerik döner. Dönen veri decode edilerek kullanıcı tarayıcısında render edilmelidir.

Örnek Request

Örnek Response

threeDSecureContent alanı Base64 decode edilerek kullanıcıya gösterilmelidir.

Son güncelleme