| Parametre Adı | Veri Tipi | Açıklama | Zorunluluk |
|---|---|---|---|
| amount | number | İşlem tutarı | Evet |
| pointAmount | number | İşlemde kullanılacak puan tutarı | Hayır |
| cardToken | string | Oluşturulan token bilgisi | Evet |
| currency | string | İşleme ait para birimi (default: TRY) | Evet |
| paymentType | string | İşlem tipi (Auth / preAuth / postAuth) | Evet |
| integrationMode | string | Entegrasyon modeli bilgisi | Hayır |
| installmentCount | integer | İşleme ait taksit değeri | Hayır |
| threeDSessionId | string | 3D Secure işlem için oluşturulan değer | Hayır |
| originalOrderId | string | Orijinal işleme ait sipariş numarası (postAuth gerekli) | Hayır |
| languageCode | string | Cevabın alınacağı dil bilgisi (default: TR) | Hayır |
| merchantCustomerName | string | Üye iş yeri müşterisinin adı | Hayır |
| merchantCustomerPhoneCode | string | Üye iş yeri müşterisinin telefon kodu | Hayır |
| merchantCustomerPhoneNumber | string | Üye iş yeri müşterisinin telefonu | Hayır |
| description | string | Açıklama | Hayır |
| cardHolderName | string | Kart sahibi adı | Hayır |
| gateway | string | Gateway bilgisi | Hayır |
| isOnUsPayment | bool | On-us ödemelerinde kullanılan parametre | Hayır |
| callbackUrl | string | Bankanın döndüğü URL adresi bilgisi | Hayır |
| merchantCustomerEmail | string | Üye iş yeri müşterisinin email bilgisi | Hayır |
| merchantCustomerIdentityNumber | string | Üye iş yeri müşterisinin kimlik bilgisi | Hayır |
| merchantCustomerIp | string | Üye iş yeri müşterisinin IP bilgisi | Hayır |
| merchantCustomerCity | string | Üye iş yeri müşterisinin şehir bilgisi | Hayır |
| merchantCustomerCountry | string | Üye iş yeri müşterisinin ülke bilgisi | Hayır |
| extraParameters | array[object] | Ek parametre alanı | Hayır |
| paymentChannel | string / bool | Ödeme kanalı bilgisi | Hayır |
| paymentSource | string | Ödeme kaynağı bilgisi | Hayı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": "test@example.com",
"MerchantCustomerIdentityNumber": "12345678901",
"MerchantCustomerIp": "192.168.1.1",
"SomeField": "SomeValue"
}
}
Ödeme Servisi Çıktı Parametreleri
| Parametre Adı | Veri Tipi | Açıklama | Zorunluluk |
|---|---|---|---|
| orderId | string | İşlem cevabında verilen sipariş numarası | Evet |
| conversationId | string | Üye iş yeri benzersiz değeri | Evet |
| isSucceeded | boolean (true/false) | İşlem durumu | Evet |
| errorCode | string | Hata kodu | Evet |
| errorMessage | string | Hata mesajı | Evet |
| provisionNumber | string | Provizyon kodu | Evet |
| description | string | Açıklama | Hayır |
| extraParameters | array[object] | Ek parametre alanı | Hayır |
| acquirerBankCode | string | Ödeme bankası bilgisi | Hayır |
| issuerBankCode | string | Kart bankası | Hayır |
| approvalCode | string | Banka onay kodu | Hayır |
| reconciliationDate | date | İşlemin tamamlandığı tarih | Hayır |
| isThreeD | bool | İşlemin 3D bilgisi | Hayır |
| maskedCardNumber | string | Maskeli kart numarası | Hayır |
| cardBrand | string | Kart markası | Hayır |
| finalAmount | number | İşlem tutarı | Hayır |
| feeAmount | number | İşlemin komisyon tutarı | Hayır |
| netAmount | number | Net tutar | Hayır |
Ödeme Servisi Örnek Response
{
"orderId": "12110000000019498253",
"provisionNumber": "156605",
"description": null,
"extraParameters": {
"MerchantExtraParameter1": "test@example.com",
"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"
}
}