# Bakiye Ödeme Servisi

API-API bakiye ödemesi gerçekleştirmek için bu servis kullanılır. "Son Ödeme Bilgisi Alma" servisinden dönen paymentType verisi "FUND" ise bu servis kullanılır.

## Fund Payment

<mark style="color:green;">`POST`</mark> `https://api.iyzipay.com/v1/pay-with-iyzico/third-party-session/checkout/auth`

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Authorization`    |
| access-token  | `{{accessToken}}`  |

### **İstek Parametreleri**

<table><thead><tr><th width="219.78515625">Parametre</th><th>Tip</th><th>Zorunluluk</th><th width="193.8878173828125">Açıklama</th></tr></thead><tbody><tr><td><code>conversationId</code></td><td>String</td><td>Hayır</td><td>İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir.</td></tr><tr><td><code>locale</code></td><td>String</td><td>Hayır</td><td>iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir.</td></tr><tr><td><code>paymentType</code></td><td>String</td><td>Evet</td><td>Ödeme tipini belirtir. Bakiye Ödemesinde "FUND" olarak gönderilmelidir.</td></tr><tr><td><code>paidPrice</code></td><td>Decimal</td><td>Evet</td><td>Tahsil edilecek nihai tutar.</td></tr><tr><td><code>price</code></td><td>Decimal</td><td>Evet</td><td>Ödeme sepet tutarı. Kırılım tutarlar toplamı, sepet tutarına eşit olmalı.</td></tr><tr><td><code>callbackUrl</code></td><td>String</td><td>Evet</td><td>Ödeme akışında üye işyerine başarılı ve hatalı sonucu bildirmek üzere alınan URL adresi. Geçerli bir ssl sertifikasına sahip olmalıdır.</td></tr><tr><td><code>paymentGroup</code></td><td>String</td><td>Hayır</td><td>Ödeme grubu, varsayılan PRODUCT. Geçerli değerler enum içinde sunulmaktadır: PRODUCT, LISTING, SUBSCRIPTION</td></tr><tr><td><code>currency</code></td><td>String</td><td>Evet</td><td>Para birimi. Default değeri TRY’dir. Kullanılabilen diğer değerler ise USD, EUR, GBP’dir.</td></tr><tr><td><code>basketId</code></td><td>String</td><td>Hayır</td><td>Üye işyeri sepet id’si.</td></tr><tr><td><code>buyerId</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait id bilgisi.</td></tr><tr><td><code>buyerName</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait ad.</td></tr><tr><td><code>buyerSurname</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait soyadı.</td></tr><tr><td><code>identityNumber</code></td><td>String</td><td>Evet</td><td>Alıcıya ait TCKN bilgisi.</td></tr><tr><td><code>email</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait e-posta bilgisi. E-posta adresi alıcıya ait geçerli ve erişilebilir bir adres olmalıdır.</td></tr><tr><td><code>gsmNumber</code></td><td>String</td><td>Hayır</td><td>Üye işyeri tarafındaki alıcıya ait GSM numarası.</td></tr><tr><td><code>registrationAddress</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait kayıt adresi.</td></tr><tr><td><code>city</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait şehir bilgisi.</td></tr><tr><td><code>country</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait ülke bilgisi.</td></tr><tr><td><code>IP</code></td><td>String</td><td>Hayır</td><td>Üye işyeri tarafındaki alıcıya ait IP adresi.</td></tr><tr><td><code>zipCode</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki alıcıya ait posta kodu.</td></tr><tr><td><code>address(shippingAddress)</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki teslimat adresi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.</td></tr><tr><td><code>contactName(shippingAddress)</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki teslimat adresi ad soyad bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.</td></tr><tr><td><code>city(shippingAddress)</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki teslimat adresi şehir bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.</td></tr><tr><td><code>country(shippingAddress)</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki teslimat adresi ülke bilgisi. Sepetteki ürünlerden en az 1 tanesi fiziksel ürün (itemType=PHYSICAL) ise zorunludur.</td></tr><tr><td><code>zipCode(shippingAddress)</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki teslimat adresi posta kodu.</td></tr><tr><td><code>address(billingAddress)</code></td><td>String</td><td>Evet</td><td>Alıcıya ait fatura adres bilgisi.</td></tr><tr><td><code>contactName(billingAddress)</code></td><td>String</td><td>Evet</td><td>Alıcıya ait fatura ad soyad bilgisi.</td></tr><tr><td><code>city(billingAddress)</code></td><td>String</td><td>Evet</td><td>Alıcıya ait fatura şehir bilgisi.</td></tr><tr><td><code>country(billingAddress)</code></td><td>String</td><td>Evet</td><td>Alıcıya ait fatura ülke bilgisi.</td></tr><tr><td><code>basketItemId</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki sepetteki ürüne ait id. Not: Bir ödeme isteğine maksimum 500 basketItem eklenebilir.</td></tr><tr><td><code>basketItemPrice</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki sepetteki ürüne ait tutar. 0 ve 0’dan küçük olamaz, tutarlar toplamı sepet tutarına (price) eşit olmalıdır.</td></tr><tr><td><code>basketItemName</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki sepetteki ürüne ait ismi.</td></tr><tr><td><code>basketItemCategory1</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki sepetteki ürüne ait 1. kategori.</td></tr><tr><td><code>basketItemCategory2</code></td><td>String</td><td>Hayır</td><td>Üye işyeri tarafındaki sepetteki ürüne ait 2. kategori.</td></tr><tr><td><code>basketItemItemType</code></td><td>String</td><td>Evet</td><td>Üye işyeri tarafındaki sepetteki ürüne ait tip. Geçerli enum değerler: PHYSICAL ve VIRTUAL</td></tr></tbody></table>

### Örnek İstek

```javascript
{
    "sessionToken": "{{sessionToken}}",
    "memberIdentifier": "{{memberIdentifier}}",
    "conversationId": "conversationId",
    "locale": "tr",
    "paymentType": "FUND",
    "paidPrice": 1.0,
    "price": 1.0,
    "callbackUrl": "callbackUrl",
    "paymentGroup": "PRODUCT",
    "currency": "TRY",
    "basketId": "B67832",
    "buyer": {
        "id": "BY789",
        "name": "John",
        "surname": "Doe",
        "identityNumber": "74300864111",
        "email": "sandboxtest0@gmail.com",
        "gsmNumber": "+905555555555",
        "registrationAddress": "Adres",
        "city": "Istanbul",
        "country": "Turkey",
        "ip": "buyer Ip",
        "zipCode": "34580"
    },
    "shippingAddress": {
        "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10",
        "contactName": "Jane Doe",
        "city": "Istanbul",
        "country": "Turkey",
        "zipCode": "34580"
    },
    "billingAddress": {
        "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10",
        "contactName": "Jane Doe",
        "city": "Istanbul",
        "country": "Turkey",
        "zipCode": "34580"
    },
    "basketItems": [
        {
            "id": "BI101",
            "price": 1.0,
            "name": "Binocular",
            "category1": "Collectibles",
            "itemType": "PHYSICAL"
        }
    ]
}
```

### Örnek Yanıt

{% tabs %}
{% tab title="200" %}

```json
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1748553300302,
    "conversationId": "conversationId",
    "sessionToken": "16f60166-74ba-4e5c-ac52-31b5762652d4",
    "paymentId": 24233528,
    "paymentStatus": "SUCCESS",
    "checkoutToken": "7ce32610-9851-4b16-939a-5d4beae75475",
    "price": 1.00000000,
    "paidPrice": 1.00000000,
    "installment": 1,
    "fraudStatus": 1,
    "merchantCommissionRate": 0E-8,
    "merchantCommissionRateAmount": 0E-8,
    "iyziCommissionRateAmount": 0.01750000,
    "iyziCommissionFee": 0E-8,
    "currency": "TRY",
    "itemTransactions": [
        {
            "itemId": "BI101",
            "paymentTransactionId": "26241258",
            "transactionStatus": 2,
            "price": 1.00000000,
            "paidPrice": 1.00000000,
            "merchantCommissionRate": 0E-8,
            "merchantCommissionRateAmount": 0E-8,
            "iyziCommissionRateAmount": 0.01750000,
            "iyziCommissionFee": 0E-8,
            "blockageRate": 0E-8,
            "blockageRateAmountMerchant": 0E-8,
            "blockageRateAmountSubMerchant": 0,
            "blockageResolvedDate": "2025-05-31 00:00:00",
            "subMerchantPrice": 0,
            "subMerchantPayoutRate": 0E-8,
            "subMerchantPayoutAmount": 0,
            "merchantPayoutAmount": 0.98250000,
            "convertedPayout": {
                "paidPrice": 1.00000000,
                "iyziCommissionRateAmount": 0.01750000,
                "iyziCommissionFee": 0E-8,
                "blockageRateAmountMerchant": 0E-8,
                "blockageRateAmountSubMerchant": 0E-8,
                "subMerchantPayoutAmount": 0E-8,
                "merchantPayoutAmount": 0.98250000,
                "iyziConversionRate": 0,
                "iyziConversionRateAmount": 0,
                "currency": "TRY"
            }
        }
    ],
    "phase": "AUTH",
    "signature": "096cf80a59d611f1702803b91bc073300e9a57a5ab47e4a839e598fc13af3d5b"
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "status": "failure",
    "errorCode": "42013",
    "errorMessage": "Bu ödemeyi gerçekleştirmek için yeterli bakiyeniz bulunmamaktadır.",
    "locale": "tr",
    "systemTime": 1749028674018
}
```

{% endtab %}
{% endtabs %}

### Yanıt Parametreleri

<table><thead><tr><th>Parametre İsmi</th><th width="103.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td><code>status</code></td><td>String</td><td>Yapılan isteğin sonucunu bildirir. Başarılı ise success, hatalı ise failure döner.</td></tr><tr><td><code>locale</code></td><td>String</td><td>İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr’dir.</td></tr><tr><td><code>systemTime</code></td><td>Long</td><td>Dönen sonucun o anki unix timestamp değeridir.</td></tr><tr><td><code>conversationId</code></td><td>String</td><td>İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.</td></tr><tr><td><code>sessionToken</code></td><td>String</td><td>Member'ın aynı ödeme tipinde  yaptığı ödeme işlemine ait session key bilgisidir.</td></tr><tr><td><code>paymentId</code></td><td>String</td><td>Ödemeye ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödemenin iptali ve iyzico ile iletişimde kullanılır.</td></tr><tr><td><code>paymentStatus</code></td><td>String</td><td>Ödeme isteğinin durumunu gösterir. Success ise karttan ilgili tutar çekilmiştir. SUCCESS, FAILURE</td></tr><tr><td><code>checkoutToken</code></td><td>String</td><td>Checkout form için oluşturulan tekil değer. Her istek için özel üretilir ve işyerine dönülür. Ödemenin sonucunu öğrenmek için zorunlu bir alandır.</td></tr><tr><td><code>price</code></td><td>Decimal</td><td>Ödeme sepet tutarı. Kırılım tutarlar toplamı sepet tutarına eşit olmalı.</td></tr><tr><td><code>paidPrice</code></td><td>Decimal</td><td>İndirim vade farkı vs. hesaplanmış POS’tan geçen, tahsil edilen, nihai tutar.</td></tr><tr><td><code>installment</code></td><td>Integer</td><td>Ödemenin taksit bilgisi, tek çekim için 1 döner. Geçerli değerler: 1, 2, 3, 6, 9, 12</td></tr><tr><td><code>fraudStatus</code></td><td>String</td><td>Ödeme işleminin fraud filtrelerine göre durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir bu durumda 1 değeri döner. Eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir ve -1 döner. Eğer ödeme işlemi daha sonradan incelenip karar verilecekse 0 döner. Geçerli değerler: 0, -1 ve 1. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.</td></tr><tr><td><code>merchantCommissionRate</code></td><td>Decimal</td><td>Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır.</td></tr><tr><td><code>merchantCommissionRateAmount</code></td><td>Decimal</td><td>Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır.</td></tr><tr><td><code>iyziCommissionRateAmount</code></td><td>Decimal</td><td>Ödemeye ait iyzico işlem komisyon tutarı.</td></tr><tr><td><code>iyziCommissionFee</code></td><td>Decimal</td><td>Ödemeye ait iyzico işlem ücreti .</td></tr><tr><td><code>currency</code></td><td>String</td><td>Ödemenin yapıldığı para birimi.</td></tr><tr><td><code>errorCode</code></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen koddur.</td></tr><tr><td><code>errorMessage</code></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.</td></tr><tr><td><code>errorGroup</code></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen gruptur.</td></tr><tr><td><code>itemId (ItemTransactions)</code></td><td>String</td><td>Üye işyeri tarafından iletilen, sepetteki ürüne ait id.</td></tr><tr><td><code>paymentTransactionId (ItemTransactions)</code></td><td>String</td><td>Ödeme kırılımına ait id, üye işyeri tarafından mutlaka saklanmalıdır. Ödeme kırılımının iadesi, onayı, onay geri çekmesi ve iyzico ile iletişimde kullanılır. Tercihen itemId ile ilişkili bir şekilde tutulmalıdır.</td></tr><tr><td><code>transactionStatus (ItemTransactions)</code></td><td>Integer</td><td>Ödeme kırılımının durumu. Ödeme fraud kontrolünde ise 0 değeri döner, bu durumda fraudStatus değeri de 0’dır. Ödeme, fraud kontrolünden sonra reddedilirse -1 döner. Pazaryeri modelinde ürüne onay verilene dek bu değer 1 olarak döner. Pazaryeri modelinde ürüne onay verilmişse bu değer 2 olur. Geçerli değerler: 0, -1, 1, 2.</td></tr><tr><td><code>price (ItemTransactions)</code></td><td>Decimal</td><td>Üye işyeri tarafındaki sepetteki ürüne ait tutar.</td></tr><tr><td><code>paidPrice(ItemTransactions)</code></td><td>Decimal</td><td>Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır.</td></tr><tr><td><code>merchantCommissionRate (ItemTransactions)</code></td><td>Decimal</td><td>Üye işyerinin uyguladığı vade/komisyon oranının kırılım bazında dağılmış oranı.</td></tr><tr><td><code>merchantCommissionRateAmount (ItemTransactions)</code></td><td>Decimal</td><td>Üye işyerinin uyguladığı vade/komisyon tutarıın, kırılım bazında dağılmış tutarı.</td></tr><tr><td><code>iyziCommissionRateAmount (ItemTransactions)</code></td><td>Decimal</td><td>iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı.</td></tr><tr><td><code>iyziCommissionFee (ItemTransactions)</code></td><td>Decimal</td><td>iyzico işlem ücretinin kırılım bazında dağılmış tutarı.</td></tr><tr><td><code>blockageRate (ItemTransactions)</code></td><td>Decimal</td><td>Kırılım bazında üye işyeri blokaj oranı. iyzico – üye işyeri anlaşmasına göre, üye işyerine işlem bazında blokaj uygulayabilir. Bu blokaj üye işyeri fraud riskini önlemek içindir, blokaj süresi boyunca para iyzico’da tutulur, bu süre sonrasında üye işyerine gönderilir.</td></tr><tr><td><code>blockageRateAmountMerchant (ItemTransactions)</code></td><td>Decimal</td><td>Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır.</td></tr><tr><td><code>blockageResolvedDate (ItemTransactions)</code></td><td>String</td><td>İşlem bazında blokaj çözülme tarihi. yyyy-MM-dd HH:mm:ss formatındadır, örneğin 2015-10-19 14:36:52.</td></tr><tr><td><code>merchantPayoutAmount (ItemTransactions)</code></td><td>Decimal</td><td>Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar.</td></tr><tr><td><code>paidPrice(convertedPayout)</code></td><td>Decimal</td><td>Tahsilat tutarının kırılım bazındaki dağılımı. Üye işyeri tarafından mutlaka saklanmalıdır.</td></tr><tr><td><code>iyziCommissionRateAmount (convertedPayout)</code></td><td>Decimal</td><td>iyzico işlem komisyon tutarının kırılım bazında dağılmış tutarı.</td></tr><tr><td><code>iyziCommissionFee (convertedPayout)</code></td><td>Decimal</td><td>iyzico işlem ücretinin kırılım bazında dağılmış tutarı.</td></tr><tr><td><code>blockageRateAmountMerchant (convertedPayout)</code></td><td>Decimal</td><td>Kırılım bazında üye işyeri blokaj tutarının, üye işyerine yansıyan rakamı. Blokaj tutarı mümkün olduğunca üye işyerine yansıtılır. Eğer blokaj tutarı, üye işyeri tutarından daha büyükse bu durumda alt üye işyerine de yansıtılır.</td></tr><tr><td><code>merchantPayoutAmount (convertedPayout)</code></td><td>Decimal</td><td>Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar.</td></tr><tr><td><code>iyziConversationRate (convertedPayout)</code></td><td>Decimal</td><td>Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar.</td></tr><tr><td><kbd><code>iyziConversationRateAmount</code></kbd><code> (convertedPayout)</code></td><td>Decimal</td><td>Bu kırılım için, iyzico işlem ücreti, komisyon tutarı ve blokajlar düşüldükten sonra üye işyerine gönderilecek tutar.</td></tr><tr><td><code>currency(convertedPayout)</code></td><td>String</td><td>Ödemenin alındığı para birimi.</td></tr><tr><td><code>phase</code></td><td>String</td><td>Ödeme fazı bilgisi. AUTH değerini alır.</td></tr><tr><td><code>signature</code></td><td>String</td><td>İmza doğrulaması için kullanılabilecek signature değeridir.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iyzico.com/odeme-metotlari/tokenize-cuzdan-odemesi/tokenization-entegrasyonu/son-odeme-bilgisi-ile-odeme-baslatma/bakiye-odeme-servisi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.