Ödeme Sorgulama

Ödeme Sorgulama servisi, bir ödeme işleminin sonucunun:

• teknik problemler nedeniyle response bilgisinden alınamadığı,

• işlem sonucunun tekrar doğrulanmak istendiği

durumlarda kullanılır.

Bu servis ile, daha önce başlatılmış bir ödemenin nihai durumu (Başarılı, Başarısız, Beklemede vb.) sistem üzerinden tekrar sorgulanabilir.

ℹ️ Ödeme sorgulama işlemi yalnızca bilgi amaçlıdır, ödeme durumunu değiştirmez.

---

Endpoint

POST /v1/Payment/CheckPayment

---

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
conversationId	✅	String	İşlem takibi için oluşturulan benzersiz kimlik	MSD2024030500000000115
sign	✅	String	İsteğin doğrulanması için dijital imza	AAVWY3RZKJVVCEAD8LDQB4K

---

Response Body

Ödeme sorgulama servisi, sorgulanan ödemenin mevcut durumunu ve detaylarını döner.

Örnek Request

POST /v1/Payment/CheckPayment
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

{
  "merchantId": 100000000000004,
  "conversationId": "MSD2024030500000000115",
  "sign": "AAVWY3RZKJVVCEAD8LDQB4K..."
}

Örnek Response

{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "02/06/2025 15:45:31",
  "mdStatus": "",
  "conversationId": "YBS57148868202773272",
  "orderId": "5000000045202502030049",
  "paymentId": "5000000045202502030049",
  "bankUniqueReferenceNumber": "503715446698",
  "paymentInstrumentType": "CARD",
  "transactionDate": "02/06/2025 15:45:17",
  "transactionStatus": "Normal",
  "transactionType": "Satış",
  "paymentInfo": {
    "installmentCommission": 0.25,
    "installmentCount": 1,
    "amount": 25.00,
    "currency": "949",
    "authCode": "683819"
  },
  "sign": "AVPGVFPHPS+HXCKT4IWQ6EYL/UMYQANXXHQ6YTNNMA8="
}