Skip to main content
Ödeme Servisi, daha önce oluşturulan kart token bilgisi kullanılarak non-secure ve 3D Secure provizyon işlemlerinin gerçekleştirilmesini sağlar. 3D Secure işlem yapılmak istendiğinde, doğrulaması tamamlanmış kartlardan tutar çekilebilmesi için threeDSessionId parametresi set edilerek bu servis çağrılır. İstek Tipi: application/json Tablo 5.5. Ödeme Servisi Girdi Parametreleri
Parametre AdıVeri TipiAçıklamaZorunluluk
amountnumberİşlem tutarıEvet
pointAmountnumberİşlemde kullanılacak puan tutarıHayır
cardTokenstringOluşturulan token bilgisiEvet
currencystringİşleme ait para birimi (default: TRY)Evet
paymentTypestringİşlem tipi (Auth / preAuth / postAuth)Evet
integrationModestringEntegrasyon modeli bilgisiHayır
installmentCountintegerİşleme ait taksit değeriHayır
threeDSessionIdstring3D Secure işlem için oluşturulan değerHayır
originalOrderIdstringOrijinal işleme ait sipariş numarası (postAuth gerekli)Hayır
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Hayır
merchantCustomerNamestringÜye iş yeri müşterisinin adıHayır
merchantCustomerPhoneCodestringÜye iş yeri müşterisinin telefon koduHayır
merchantCustomerPhoneNumberstringÜye iş yeri müşterisinin telefonuHayır
descriptionstringAçıklamaHayır
cardHolderNamestringKart sahibi adıHayır
gatewaystringGateway bilgisiHayır
isOnUsPaymentboolOn-us ödemelerinde kullanılan parametreHayır
callbackUrlstringBankanın döndüğü URL adresi 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
merchantCustomerCitystringÜye iş yeri müşterisinin şehir bilgisiHayır
merchantCustomerCountrystringÜye iş yeri müşterisinin ülke bilgisiHayır
extraParametersarray[object]Ek parametre alanıHayır
paymentChannelstring / boolÖdeme kanalı bilgisiHayır
paymentSourcestringÖdeme kaynağı bilgisiHayır

​
Ödeme Servisi Örnek Request

{
  "amount": 5,
  "pointAmount": 0,
  "cardToken": "{{cardToken}}",
  "currency": "TRY",
  "paymentType": "Auth",
  "integrationMode": "API",
  "installmentCount": 0,
  "threeDSessionId": "",
  "originalOrderId": "",
  "languageCode": "TR",
  "description": "",
  "gateway": "",
  "callbackUrl": "string",
  "cardHolderName": "Kart Sahibi",
  "merchantCustomerName": "Ahmet Yılmaz",
  "isOnUsPayment": false,
  "merchantCustomerPhoneCode": "+90",
  "merchantCustomerPhoneNumber": "5307988566",
  "merchantCustomerEmail": "deneme",
  "merchantCustomerIdentityNumber": "99999999999",
  "merchantCustomerIp": "21.123.11.12",
  "merchantCustomerCity": "Adana",
  "merchantCustomerCountry": "Türkiye",
  "paymentChannel": "CC",
  "paymentSource": "web",
  "extraParameters": {
    "MerchantExtraParameter1": "[email protected]",
    "MerchantCustomerIdentityNumber": "12345678901",
    "MerchantCustomerIp": "192.168.1.1",
    "SomeField": "SomeValue"
  }
}

​
Ödeme Servisi Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
orderIdstringİşlem cevabında verilen sipariş numarasıEvet
conversationIdstringÜye iş yeri benzersiz değeriEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
provisionNumberstringProvizyon koduEvet
descriptionstringAçıklamaHayır
extraParametersarray[object]Ek parametre alanıHayır
acquirerBankCodestringÖdeme bankası bilgisiHayır
issuerBankCodestringKart bankasıHayır
approvalCodestringBanka onay koduHayır
reconciliationDatedateİşlemin tamamlandığı tarihHayır
isThreeDboolİşlemin 3D bilgisiHayır
maskedCardNumberstringMaskeli kart numarasıHayır
cardBrandstringKart markasıHayır
finalAmountnumberİşlem tutarıHayır
feeAmountnumberİşlemin komisyon tutarıHayır
netAmountnumberNet tutarHayır

​
Ödeme Servisi Örnek Response

{
  "orderId": "12110000000019498253",
  "provisionNumber": "156605",
  "description": null,
  "extraParameters": {
    "MerchantExtraParameter1": "[email protected]",
    "MerchantCustomerIdentityNumber": "12345678901",
    "MerchantCustomerIp": "192.168.1.1",
    "SomeField": "SomeValue"
  },
  "acquirerBankCode": "12",
  "issuerBankCode": "0",
  "approvalCode": null,
  "reconciliationDate": "20251205165616793",
  "isThreeD": false,
  "maskedCardNumber": "979210******0001",
  "cardBrand": null,
  "finalAmount": 5.0,
  "feeAmount": 0.15,
  "netAmount": 4.85,
  "isSucceed": true,
  "errorCode": null,
  "errorMessage": null,
  "responseHeader": {
    "conversationId": "2006891309",
    "responseDateTime": "20251205165616937",
    "responseCode": "00",
    "responseDescription": "00",
    "transactionId": "e90c0510-380d-4719-bff2-7cce4382859f",
    "requestId": "1111111111111",
    "processingTime": 3895,
    "apiVersion": "1.0.1"
  }
}