# Retrieve Payment Detail and Session Info

Returns the details of the payments made by the Member within the scope of the session. The payment that starts the session with Pay with iyzico (PWI) is within this scope.

### Payment and Session Retrieve

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

### **Request Parameters**

<table><thead><tr><th width="190.3515625">Paremeter</th><th>Type</th><th>Mandatory</th><th>Description</th></tr></thead><tbody><tr><td><code>checkoutFormToken</code></td><td>string</td><td>Evet</td><td>The token value of the transaction.</td></tr><tr><td><code>locale</code></td><td>string</td><td>Hayır</td><td>The language value sent for the request. Can take the value EN and TR.</td></tr><tr><td><code>conversationId</code></td><td>string</td><td>Hayır</td><td>A value that you can send during the request and receive in the result can be used to make a request/response match.</td></tr></tbody></table>

### Request

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

### Response

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

```json
{
    "status": "success",
    "locale": "en",
    "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": "5126",
    "errorMessage": "Token does not belong to this merchant",
    "locale": "en",
    "systemTime": 1750241113790,
    "conversationId": "8152109759"
}
```

{% endtab %}
{% endtabs %}

### Response Parameters

<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>Service response result (success / failure).</td></tr><tr><td><code>locale</code></td><td>String</td><td>Language. Default: TR<br>Can take TR and EN values.</td></tr><tr><td><code>systemTime</code></td><td>Long</td><td>Response system timestamp value.</td></tr><tr><td><code>conversationId</code></td><td>String</td><td>If set, conversation ID to match request and response.</td></tr><tr><td><code>token</code></td><td>String</td><td>The token value of the checkoutform used in the checkout process.</td></tr><tr><td><code>paymentStatus</code></td><td>String</td><td>Payment response result (SUCCESS, FAILURE).</td></tr><tr><td><code>memberEmail</code></td><td>String</td><td>Member's email information.</td></tr><tr><td><code>memberGsmNumber</code></td><td>String</td><td>Member's gsm number information.</td></tr><tr><td><code>price</code></td><td>Decimal</td><td>Total amount of basket.</td></tr><tr><td><code>paidPrice</code></td><td>Decimal</td><td>Final amount (including installment fee) that will be charged to customer’s card. Merchants should store this value in their system.</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>ID of the payment. Merchants should keep payment ID in their system (this ID will be used for cancel requests).</td></tr><tr><td><code>fraudStatus</code></td><td>Integer</td><td><p></p><p>Payment status according to fraud filters. If the risk score is low, the payment is approved immediately; if the risk score is high, the payment is rejected. The merchant should ship only when the value is <strong>1</strong>; for <strong>0</strong>, wait for notification.<br></p><ul><li><strong>1</strong>: Approved</li><li><strong>0</strong>: In review</li><li><strong>-1</strong>: Rejected</li></ul></td></tr><tr><td><code>merchantCommissionRate</code></td><td>Decimal</td><td>Merchant commission rate (e.g. price=100 &#x26; paidPrice=110, then merchant commission rate = 10).</td></tr><tr><td><code>merchantCommissionRateAmount</code></td><td>Decimal</td><td>Merchant commission rate amount (e.g. price=100 &#x26; paidPrice=110, then merchant commission rate amount = 10).</td></tr><tr><td><code>iyziCommissionRateAmount</code></td><td>Decimal</td><td>iyzico commission rate amount for payment transaction.</td></tr><tr><td><code>iyziCommissionFee</code></td><td>Decimal</td><td>iyzico commission fee for payment transaction.</td></tr><tr><td><code>basketId</code></td><td>String</td><td>Merchant's basket ID.</td></tr><tr><td><code>errorCode</code></td><td>String</td><td>Error code if service response status is failure.</td></tr><tr><td><code>errorMessage</code></td><td>String</td><td>Error message if service response status is failure.</td></tr><tr><td><code>errorGroup</code></td><td>String</td><td>Error group if service response status is failure.</td></tr><tr><td><code>currency</code></td><td>String</td><td>The currency in which payment is received.</td></tr><tr><td><code>itemId (ItemTransactions)</code></td><td>String</td><td>Item ID of each item in basket.</td></tr><tr><td><code>transactionStatus (ItemTransactions)</code></td><td>Integer</td><td>The status of the payment breakdown. Returns 0 if the payment is under fraud check, in which case the fraudStatus is also 0. -1 if the payment is rejected after the fraud check. In the marketplace model, this value returns 1 until the product is approved. If the product is approved in the marketplace model, this value is 2. Valid values: 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>Item price of each item in basket.</td></tr><tr><td><code>paidPrice (ItemTransactions)</code></td><td>Decimal</td><td>Captured amount from card based on each item. Merchants should keep paidPrice in their system.</td></tr><tr><td><code>merchantCommissionRate (ItemTransactions)</code></td><td>Decimal</td><td>The ratio of the maturity/commission rate applied by the merchant, broken down by segment.</td></tr><tr><td><code>merchantCommissionRateAmount (ItemTransactions)</code></td><td>Decimal</td><td>Amount of the maturity/commission amount applied by the merchant, broken down on a breakdown basis.</td></tr><tr><td><code>iyziCommissionRateAmount (ItemTransactions)</code></td><td>Decimal</td><td>iyzico commission rate amount for payment transaction.</td></tr><tr><td><code>iyziCommissionFee (ItemTransactions)</code></td><td>Decimal</td><td>iyzico commission fee for payment transaction.</td></tr><tr><td><code>blockageRate (ItemTransactions)</code></td><td>Decimal</td><td>Merchant blockage rate on a breakdown basis. iyzico may apply transaction-based blockage to the merchant according to the iyzico - merchant agreement. This blockage is to prevent merchant fraud risk, the money is kept at iyzico during the blockage period and sent to the merchant after this period.</td></tr><tr><td><code>blockageRateAmountMerchant (ItemTransactions)</code></td><td>Decimal</td><td>The amount of the merchant blockage amount reflected to the merchant on a breakdown basis. The blockage amount is reflected to the merchant as much as possible. If the blockage amount is greater than the merchant amount, then it is also reflected to the sub-merchant.</td></tr><tr><td><code>blockageResolvedDate (ItemTransactions)</code></td><td>String</td><td>Date of unblocking by transaction. yyyy-MM-dd HH:mm:ss format, for example 2015-10-19 14:36:52.</td></tr><tr><td><code>merchantPayoutAmount (ItemTransactions)</code></td><td>Decimal</td><td>Payout amount for each item transaction. This is the amount that remains after after substracting iyzicoCommissionRateAmount, iyzicoCommissionFee and blockageRateAmountMerchant from paidPrice(ItemTransactions)</td></tr><tr><td><code>paidPrice(convertedPayout)</code></td><td>Decimal</td><td>Converted charged amount to card based on each item. Merchants should keep paidPrice in their system.</td></tr><tr><td><code>iyziCommissionRateAmount (convertedPayout)</code></td><td>Decimal</td><td>Converted iyzico commission rate amount based on each item.</td></tr><tr><td><code>iyziCommissionFee (convertedPayout)</code></td><td>Decimal</td><td>Converted iyzico commission fee based on each item.</td></tr><tr><td><code>blockageRateAmountMerchant (convertedPayout)</code></td><td>Decimal</td><td>The amount of the merchant blockage amount reflected to the merchant on a breakdown basis. The blockage amount is reflected to the merchant as much as possible. If the blockage amount is greater than the merchant amount, then it is also reflected to the sub-merchant.</td></tr><tr><td><code>merchantPayoutAmount (convertedPayout)</code></td><td>Decimal</td><td>Converted payout amount for each item transaction. This the amount that remains after substracting iyzicoCommissionRateAmount, iyzicoCommissionFee and blockageRateAmountMerchant from paidPrice(ItemTransactions).</td></tr><tr><td><code>iyziConversationRate (convertedPayout)</code></td><td>Decimal</td><td>iyzico conversation rate.</td></tr><tr><td><code>iyziConversationRateAmount (convertedPayout)</code></td><td>Decimal</td><td>For this breakdown, the amount to be sent to the merchant after deducting iyzico transaction fee, commission amount and blockages.</td></tr><tr><td><code>currency (convertedPayout)</code></td><td>String</td><td>Currency for payout conversion.</td></tr><tr><td><code>mdStatus</code></td><td>String</td><td>It is the value returned from the bank. This value is returned only if the payment failed and the transaction was made with 3ds. It can take the values 0,2,3,4,5,6,7.<br>If the 3D Transaction is Successful, it takes the value 1.</td></tr><tr><td><code>authCode</code></td><td>String</td><td>uniq value produced by iyzico.</td></tr><tr><td><code>phase</code></td><td>String</td><td>Payment phase information. Takes the value AUTH.</td></tr><tr><td><code>signature</code></td><td>String</td><td>The signature value that can be used for signature verification.</td></tr><tr><td><code>cardType</code></td><td>String</td><td>Returns only for card payments. If the payment card is a local card, it returns the card type information. It takes the values DEBIT_CARD and CREDIT_CARD.</td></tr><tr><td><code>cardAssociation</code></td><td>String</td><td>Returns only for card payments.<br>If the payment card is a local card, the organization to which the card belongs. Valid values: VISA, MASTER_CARD, AMERICAN_EXPRESS, TROY</td></tr><tr><td><code>cardFamily</code></td><td>String</td><td>Returns only for card payments.<br>If the payment card is a local card, the family to which the card belongs. Valid values: Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage</td></tr><tr><td><code>binNumber</code></td><td>String</td><td>First 6 digit of card.</td></tr><tr><td><code>lastFourDigits</code></td><td>String</td><td>Last 4 digits of the payment card.</td></tr><tr><td><code>sessionToken(sessionInfo)</code></td><td>String</td><td>This is the session key information of the payment transaction made by the Member in the same payment type.</td></tr><tr><td><code>sessionStatus(sessionInfo)</code></td><td>String</td><td>Session status of the user. It takes ACTIVE or PASSIVE values.</td></tr><tr><td><code>memberIdentifier(sessionInfo)</code></td><td>String</td><td>Member unique key information. This key is used for member information in payment transactions.</td></tr><tr><td><code>paymentType(sessionInfo)</code></td><td>String</td><td>Specifies the payment type. It can return FUND or CARD_PAYMENT.<br>FUND Balance Payment<br>CARD_PAYMENT: Card Payment</td></tr><tr><td><code>callbackUrl</code></td><td>String</td><td>The URL address specified in the request and redirected as a result of the operation.</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/en/payment-methods/tokenization/tokenization-integration/retrieve-payment-detail-and-session-info.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.