> ## Documentation Index
> Fetch the complete documentation index at: https://developer.1000pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ödeme Servisi (Provision)

> Ödeme Servisi, kart token kullanarak non-secure ve 3D Secure ödeme işlemlerinin gerçekleştirilmesini sağlar.

Ö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 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

<CodeGroup dropdown>
  ```json theme="dracula" theme={null}
  {
    "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"
    }
  }
  ```
</CodeGroup>

### Ö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

<CodeGroup dropdown>
  ```json theme="dracula" theme={null}
  {
    "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"
    }
  }
  ```
</CodeGroup>