İptal

İptal servisi, başarılı bir ödemenin henüz finansallaşmadan aynı gün içerisinde iptal edilmesini sağlar.

Bu servis ile:

• Ödeme geri alınır.

• Banka ve üye işyeri kayıtları güncellenir.

• İptal işlemi için işlem takibi sağlanır.

⚠️ İptal işlemi sadece aynı gün finansallaşmamış ödemeler için geçerlidir. Finansallaşmış ödemelerde iade (Refund) servisi kullanılmalıdır.

---

Endpoint

POST /v1/Payment/DoPayment

---

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 kimlik numarası	100000000000004
paymentId	✅	String	İptal edilecek ödemenin kimlik numarası	100000000000004202402140248
conversationId	✅	String	İşlem takip numarası	MSD29715509646227267
sign	✅	String	İsteğin doğrulanması için dijital imza	PT6JMMJANWWQ6DN5M+DUGIZW4DSVJHX0NI2JRJ0XT3O=
transactionDetails.transactionType	✅	String	İşlem türü (VOID = iptal)	VOID
transactionDetails.currency	✅	String	Para birimi kodu (ISO 4217)	949
language	✅	String	İşlem dili	tr

---

Response Body

İptal işlemi başarılı ise, sistem aşağıdaki yanıtı döner:

Örnek Request

POST /v1/Payment/DoPayment
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,
  "paymentId": "100000000000004202402140248",
  "conversationId": "MSD29715509646227267",
  "sign": "PT6JMMJANWWQ6DN5M+DUGIZW4DSVJHX0NI2JRJ0XT3O=",
  "transactionDetails": {
    "transactionType": "VOID",
    "currency": "949"
  },
  "language": "tr"
}

Örnek Response

{
  "code": "00",
  "message": "Approved",
  "resultCode": "00",
  "resultDescription": "Başarılı",
  "responseDate": "11/03/2024 12:34:40",
  "conversationId": "MSD29715509646227267",
  "orderId": "100000000000004202402140248",
  "paymentId": "100000000000004202402140248",
  "bankUniqueReferenceNumber": "407100003684",
  "authCode": "562660",
  "sign": "F7GJMMJANWWQ6DN5M+DUGIZW4DSVJHXJNI2JRJ0XT3O="
}