3D Ödeme Tamamla

3D Ödeme Tamamlama adımı, 3D Secure doğrulaması tamamlanan bir ödemenin sistemsel olarak başarılı veya başarısız şekilde kesinleştirilmesini sağlar.

Kullanıcının bankanın 3D Secure ekranında gerçekleştirdiği aksiyonun ardından, banka tarafından işlem sonucu Init3d adımında tanımlanan returnUrl veya failUrl adresine HTTP Request olarak iletilir.

Üye işyeri, bu URL’e gelen Request içeriğini kullanarak Auth3d servisine çağrı yapmalı ve ödeme sürecini sonlandırmalıdır.

⚠️ Bu adım çağrılmadan 3D ödeme tamamlanmış sayılmaz.

---

Endpoint

POST /v1/Payment/Auth3d

---

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

Bu alanlar, returnUrl / failUrl adresine banka tarafından gönderilen Request içeriğinden alınarak iletilmelidir.

Alan	Zorunlu	Tür	Açıklama	Örnek
Code	✅	String	İşlem sonucu kodu	B0000
Message	✅	String	İşlem durumu	Approved
EftCode	✅	String	EFT işlem kodu	0150
MdStatus	✅	String	3D doğrulama durum bilgisi	UGF5...ODRD
MdStatusMessage	✅	String	3D doğrulama mesajı	(Boş)
conversationId	✅	String	İşlem takip numarası	MSD2024030500000000115
OrderId	✅	String	Sipariş kimliği	5000000045202502030044
PaymentId	✅	String	Ödeme kimliği	5000000045202502030044
TransactionDate	✅	DateTime	İşlem tarihi ve saati	05/02/2025 16:16:10
Currency	✅	Integer	Para birimi kodu (ISO 4217)	949
PaymentInstrumentType	✅	String	Ödeme aracı türü	CARD
MerchantId	✅	String	Üye işyeri kimliği	5000000045
InstrumentDetail	✅	Object	Ödeme aracı detay bilgisi	InstrumentDetailVM

---

Response Body

Auth3d çağrısına verilen yanıt, ödemenin nihai sonucunu içerir.

Örnek Request

POST /v1/Payment/Auth3d
Content-Type: application/json
x-ClientID: sizin-istemci-id'niz
x-ClientSecret: sizin-gizli-anahtarınız
x-GrantType: istemci_kimlik_bilgileri
x-Scope: pf_write, pf_read
x-Timestamp: 2024-12-17T12:34:56Z

{
  "Code": "B0000",
  "Message": "Approved",
  "EftCode": "0150",
  "MdStatus": "UGF5...ODRD",
  "MdStatusMessage": "",
  "conversationId": "MSD2024030500000000115",
  "OrderId": "5000000045202502030044",
  "PaymentId": "5000000045202502030044",
  "TransactionDate": "05/02/2025 16:16:10",
  "Currency": 949,
  "PaymentInstrumentType": "CARD",
  "MerchantId": "5000000045",
  "InstrumentDetail": {}
}

Örnek Response

{
  "code": "B0000",
  "message": "Onaylandı",
  "resultCode": "B0000",
  "resultDescription": "Onaylandı",
  "responseDate": "05/02/2025 16:16:10",
  "conversationId": "MSD2024030500000000115",
  "orderId": "5000000045202502030044",
  "paymentId": "5000000045202502030044",
  "bankUniqueReferenceNumber": "503615446559",
  "transactionDate": "05/02/2025 16:16:10",
  "currency": "949",
  "authCode": "655050",
  "paymentInstrumentType": "CARDPAYMENT",
  "instrumentDetail": {
    "maskedCardNumber": "524677******3508",
    "cardType": "CARD"
  },
  "paymentInfo": {
    "installmentCount": 1,
    "payFacCommissionRate": 1.00,
    "amount": 25.00,
    "payFacCommissionAmount": 0.2500
  },
  "okUrl": null,
  "failUrl": null
}