Skip to main content
Bu servis, yapılan finansal işlemin sonucunu sorgulamak için kullanılır. Provision servisi normalde işlem sonucunu senkron olarak döner; ancak herhangi bir nedenle yanıt alınamayan durumlarda, işlem sorgulama servisi aracılığıyla ilgili işlemin güncel durumu öğrenilebilir. İstek Tipi: application/json Tablo 5.23. Inquire Servisi Girdi Parametreleri
Parametre AdıVeri TipiAçıklamaZorunluluk
paymentConversationIdstringÖdeme esnasında verilen benzersiz değerEvet
orderIdstringProvizyon işlemi cevabında verilen sipariş numarasıEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Hayı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 numarası bilgisiHayır
{
  "paymentConversationId": "1515954869",
  "languageCode": "TR",
  "orderId": "",
  "merchantCustomerEmail": "[email protected]",
  "merchantCustomerIdentityNumber": "20556978630",
  "merchantCustomerIp": "123.12.12.21",
  "merchantCustomerPhoneCode": "90",
  "merchantCustomerPhoneNumber": "5305588999"
}

​
Tablo 5.25. Inquire Servisi Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
paymentConversationIdstringÖdeme esnasında verilen benzersiz değerEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
orderIdstringProvizyon işlemi cevabında verilen sipariş numarasıEvet
transactionTypestringİşlem tipi (Auth / PreAuth / Return / PostAuth / Reverse)Evet
transactionStatusstringİşlem durumu (Pending / Fail / Success / Returned / PartiallyReturned / Reversed / Closed / PartiallyClosed)Evet
amountnumberİşlem tutarıEvet
pointAmountnumberİşlemde kullanılacak puan tutarıHayır
currencystringİşleme ait para birimi (default: TRY)Evet
installmentCountintegerİşleme ait taksit değeriHayır
binNumberstringİşlem yapılan karta ait BIN değeriEvet
cardNumberstringKart numarasıEvet
cardBrandstringKart markası (Undefined / JCB / UnionPay / Maestro / Amex / Visa / Troy / Master / Discover / Diners)Evet
cardNetworkstringKart ağı (Unknown / CardFinans / MilesSmiles / World / Paraf / Maximum / Axess / AsyaCard / Advantage / Bonus / BankKartCombo)Evet
cardTypestringKart tipi (Unknown / Credit / Debit / Prepaid)Evet
issuerBankCodeintegerKartın bankasına ait kodEvet
is3dsboolean (true/false)İşlemin 3D Secure bilgisiEvet
approvalCodestringBankadan dönen onay koduHayır
returnStatusstringİade durumu bilgisiHayır
provisionListlistİşlem tarihçesi ve detayları (amount, transactionStatus, transactionType, transactionDate, provisionNumber, reconciliationStatus)Evet

​
Tablo 5.26. Inquire Servisi Örnek Response

{
  "paymentConversationId": "3dd9ede9-2282-4d33-a956-dc01a7b6d5ef",
  "orderId": "",
  "transactionType": "Auth",
  "transactionStatus": "Fail",
  "amount": 10.0,
  "pointAmount": 0.0,
  "currency": "",
  "installmentCount": 2,
  "binNumber": "",
  "cardNumber": "",
  "cardBrand": "Undefined",
  "cardNetwork": "Unknown",
  "cardType": "Unknown",
  "issuerBankCode": 0,
  "is3ds": false,
  "provisionList": [
    {
      "amount": 10.0,
      "transactionStatus": "Fail",
      "transactionType": "Auth",
      "transactionDate": "2025-05-16 13:43:49",
      "reconciliationDate": "20250516000000000",
      "provisionNumber": null
    }
  ],
  "returnStatus": "NoAction",
  "approvalCode": null,
  "isSucceeded": true,
  "errorCode": "",
  "errorMessage": "",
  "responseHeader": {
    "conversationId": "1094389093",
    "responseDateTime": "20251205170457401",
    "responseCode": "PFC005",
    "responseDescription": "VposNotFoundException - MissingMerchantVposException",
    "transactionId": "e905100d-2b31-4897-82b1-9f7f9570ffcc",
    "requestId": "781d84c5-8537-4d26-a253-210f9f46fec5",
    "processingTime": 393,
    "apiVersion": "1.0.1"
  }
}