> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/odeme-metotlari/tokenize-cuzdan-odemesi/tokenization-entegrasyonu/odeme-ve-session-sorgulama.md).

# Ödeme ve Session Sorgulama

Member'ın session kapsamında yaptığı ödemelerin detayını döner. iyzico ile Öde (PWI) ile session başlatan ödeme bu kapsamdadır.

### Ödeme ve Session Sorgulama

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

#### **Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Authorization`    |

### **İstek Parametreleri**

<table><thead><tr><th width="190.3515625">Paremetre</th><th>Tip</th><th>Zorunluluk</th><th>Açıklama</th></tr></thead><tbody><tr><td><code>checkoutFormToken</code></td><td>string</td><td>Evet</td><td>Yapılan işleme ait token değeri.</td></tr><tr><td><code>locale</code></td><td>string</td><td>Hayır</td><td>İstek için gönderilen dil değeri. EN ve TR değerini alabilir.</td></tr><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></tbody></table>

### Örnek İstek

```json
{
    "checkoutFormToken": "{{checkoutToken}}",
    "locale": "tr",
    "conversationId": "conversationId"
}
```

### Örnek Yanıt

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

```json
{
    "status": "success",
    "locale": "tr",
    "systemTime": 1749032413350,
    "conversationId": "conversationId",
    "token": "e54b957b-a153-410c-8761-79c9bd4ff44f",
    "callbackUrl": "https://merchant-callback.com",
    "paymentStatus": "SUCCESS",
    "price": 1.00000000,
    "paidPrice": 1.00000000,
    "installment": 1,
    "paymentId": "24259238",
    "fraudStatus": 1,
    "memberEmail": "sandboxtest@gmail.com",
    "memberGsmNumber": "+905555555555",
    "merchantCommissionRate": 0E-8,
    "merchantCommissionRateAmount": 0E-8,
    "iyziCommissionRateAmount": 0.01750000,
    "iyziCommissionFee": 0E-8,
    "cardType": "CREDIT_CARD",
    "cardAssociation": "MASTER_CARD",
    "cardFamily": "Advantage",
    "binNumber": "550472",
    "lastFourDigits": "0003",
    "basketId": "B67832",
    "currency": "TRY",
    "itemTransactions": [
        {
            "itemId": "BI101",
            "paymentTransactionId": "26268394",
            "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": 0E-8,
            "blockageResolvedDate": "2025-06-05 00:00:00",
            "subMerchantPrice": 0E-8,
            "subMerchantPayoutRate": 0E-8,
            "subMerchantPayoutAmount": 0E-8,
            "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": 0E-8,
                "iyziConversionRateAmount": 0E-8,
                "currency": "TRY"
            }
        }
    ],
    "authCode": "054626",
    "phase": "AUTH",
    "hostReference": "mock00034iyzihostrfn",
    "signature": "a77fac0a954181b9816bac2d0ba55047d2bfb1934d8efaa6de39b93b91bc9d6c",
    "sessionInfo": {
        "sessionToken": "f403ef2f-fb08-4111-afd6-495811ef6b25",
        "sessionStatus": "ACTIVE",
        "memberIdentifier": "f1409923-57cb-468f-8df2-704ea02075e3",
        "paymentType": "CARD_PAYMENT"
    }
}
```

{% endtab %}

{% tab title="400" %}

```json
{
    "status": "failure",
    "errorCode": "5122",
    "errorMessage": "Gönderilen tokena ait ödeme bilgisi bulunamadı",
    "locale": "tr",
    "systemTime": 1749021962085,
    "conversationId": "conversationId"
}
```

{% 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>token</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>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>fraudStatus</code></td><td>Integer</td><td><p></p><p>Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.<br></p><ul><li>1: Onaylandı</li><li>0: İncelemede</li><li>-1: Reddedildi</li></ul></td></tr><tr><td><code>memberEmail</code></td><td>String</td><td>İşlem yapan member'ın email bilgisi</td></tr><tr><td><code>memberGsmNumber</code></td><td>String</td><td>İşlem yapan member'ın gsm number bilgisi</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>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>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>basketId</code></td><td>String</td><td>Üye işyeri tarafından gönderilen sepet id’si.</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>currency</code></td><td>String</td><td>Ödemenin alındığı para birimi.</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>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>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>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><code>iyziConversationRateAmount (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>mdStatus</code></td><td>String</td><td>Bankadan dönen değerdir. Sadece ödeme başarısız ise ve işlem 3ds ile yapılmışsa bu değer döner. 0,2,3,4,5,6,7 değerlerini alabilir.<br>3D İşlemi Başarılı ise 1 değerini alır.</td></tr><tr><td><code>authCode</code></td><td>String</td><td>iyzico tarafından üretilen uniq değer.</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><tr><td><code>cardType</code></td><td>String</td><td>Sadece kartlı ödemelerde döner. Eğer ödeme yapılan kart yerel bir kart ise, kart tipi bilgisini döner. DEBIT_CARD ve CREDIT_CARD değerlerini alır.</td></tr><tr><td><code>cardAssociation</code></td><td>String</td><td>Sadece kartlı ödemelerde döner. <br>Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler: VISA, MASTER_CARD, AMERICAN_EXPRESS, TROY</td></tr><tr><td><code>cardFamily</code></td><td>String</td><td>Sadece kartlı ödemelerde döner. <br>Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu aile. Geçerli değerler: Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage</td></tr><tr><td><code>binNumber</code></td><td>String</td><td>Ödeme yapılan kartın ilk 6 hanesi.</td></tr><tr><td><code>lastFourDigits</code></td><td>String</td><td>Ödeme yapılan kartın son 4 hanesi.</td></tr><tr><td><code>sessionToken(sessionInfo)</code></td><td>String</td><td>Member'ın aynı ödeme tipinde yaptığı ödeme işlemine ait session key bilgisidir.</td></tr><tr><td><code>sessionStatus(sessionInfo)</code></td><td>String</td><td>Kullanıcıya ait session durumudur. ACTIVE veya PASSIVE değerlerini alır.</td></tr><tr><td><code>memberIdentifier(sessionInfo)</code></td><td>String</td><td>Member unique key bilgisidir. Bu key, ödeme işlemlerinde member bilgisi için kullanılır.</td></tr><tr><td><code>paymentType(sessionInfo)</code></td><td>String</td><td>Ödeme tipini belirtir. FUND veya CARD_PAYMENT değerlerini dönebilir.<br>FUND: Bakiye Ödemesi<br>CARD_PAYMENT: Kart Ödemesi</td></tr><tr><td><code>callbackUrl</code></td><td>String</td><td>İstekte belirtilen ve işlem sonucunda yönlendirilen URL adres bilgisidir.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.iyzico.com/odeme-metotlari/tokenize-cuzdan-odemesi/tokenization-entegrasyonu/odeme-ve-session-sorgulama.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.