Skip to main content
İade Servisi, gerçekleştirilen bir finansal işlemin tamamının veya belirli bir kısmının karta iade edilmesi için kullanılır. İade işlemleri, gün sonu sonrasında gerçekleştirilebilir. Aynı işlem için birden fazla iade çağrısı yapılabilir; ancak iptal edilmiş işlemler için iade yapılamaz ve toplam iade tutarı, işlem tutarını aşamaz. İstek Tipi: application/json

​
Tablo 5.31. Return Servisi Girdi Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
amountstringİade edilecek tutarEvet
orderIdstringProvizyon işlemi cevabında verilen sipariş numarasıEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Hayır
paymentChannelstringÖdeme kanalı bilgisiHayır
merchantCustomerEmailstringÜye iş yeri müşterisinin email bilgisiHayır
merchantCustomerIdentityNumberstringÜye iş yeri müşterisinin kimlik bilgisiHayır
merchantCustomerIpstringÜye iş yeri müşterisinin IP bilgisiHayır
merchantCustomerPhoneCodestringÜye iş yeri müşterisinin telefon kodu bilgisiHayır
merchantCustomerPhoneNumberstringÜye iş yeri müşterisinin telefon no bilgisiHayır
reasonstringİade açıklaması (reason)Hayır

​
Tablo 5.32. Return Servisi Örnek Request

{
  "amount": 5,
  "orderId": "15123456780250195126",
  "languageCode": "TR",
  "paymentChannel": "PF",
  "merchantCustomerEmail": "[email protected]",
  "merchantCustomerIdentityNumber": "20668899522",
  "merchantCustomerIp": "123.123.12.12",
  "merchantCustomerPhoneCode": "90",
  "merchantCustomerPhoneNumber": "5301231234",
  "reason": "İade nedeni test"
}

​
Tablo 5.33. Return Servisi Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
conversationIdstringÜye iş yeri benzersiz değeriEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
returnMessagestringDönüş mesajıEvet
provisionNumberstringProvizyon koduEvet
approvalStatusstringOnay durumuEvet
orderIdstringSipariş bilgisiEvet
refundAmountnumberİade işlem tutarıHayır
remainingAmountnumberKalan işlem tutarıHayır
paymentChannelstring / boolÖdeme kanalı bilgisiHayır

​
Tablo 5.34. Return Servisi Örnek Response

{
  "returnMessage": null,
  "approvalStatus": "Approved",
  "provisionNumber": "029139",
  "orderId": null,
  "refundAmount": 5.0,
  "remainingAmount": 0.0,
  "paymentChannel": "PF",
  "isSucceeded": true,
  "errorCode": "",
  "errorMessage": "",
  "responseHeader": {
    "conversationId": "1094389093",
    "responseDateTime": "20251205171556679",
    "responseCode": "00",
    "responseDescription": "Approved",
    "transactionId": "00000000-0000-0000-0000-000000000000",
    "requestId": "0c8fe2cd-860d-4dd5-b98a-6ef56330597e",
    "processingTime": 3942,
    "apiVersion": "1.0.1"
  }
}