# İptal / İade

Başarılı gerçekleşen bir ödemeyi iptal veya iade etmek istediğinizde bu servisi kullanabilirsiniz.

{% hint style="danger" %}
İptal / İade işlemi **fiziki** olarak gerçekleşmek zorundadır. **Ceppos işlemleri iyzico paneli üzerinden iade edilememektedir.**
{% endhint %}

<mark style="color:orange;">`POST`</mark> `https://api.iyzipay.com/v2/in-store/payment/refund`

#### Headers

| Parametre          | Zorunluluk | Veri Tipi | Açıklama                                                         |
| ------------------ | ---------- | --------- | ---------------------------------------------------------------- |
| **x-api-key**      | Zorunlu    | String    | CepPOS API Anahtarı                                              |
| **x-secret-key**   | Zorunlu    | String    | CepPOS Güvenlik Anahtarı                                         |
| **x-merchant-id**  | Zorunlu    | Integer   | Üye İşyeri Numarası                                              |
| **x-callback-url** | Zorunlu    | String    | İşlem sonrası uygulamanıza geri dönülmesi sağlayan parametredir. |

#### **İstek Parametreleri**

| Parametre        | Zorunluluk | Veri Tipi | Açıklama                                                |
| ---------------- | ---------- | --------- | ------------------------------------------------------- |
| **refundAmount** | Evet       | Number    | İptal/İade edilmek istenen tutar.                       |
| **paymentId**    | Evet       | Integer   | Ödemenin iyzico tarafındaki işlem id'sidir.             |
| **email**        | Evet       | String    | İlgili üye işyerine ait kullanıcının eposta bilgisidir. |

#### İstek Örneği

```json
{
    "refundAmount": "26",
    "paymentId": 123456,
    "email": "kullanici1@iyzico.com"
}
```

#### Yanıt **Parametreleri**

Kullanıcı listeleme servisinden dönen parametreler aşağıdaki gibidir.

<table><thead><tr><th width="229">Parametre</th><th>Veri Tipi</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>status</strong></td><td>String</td><td>Yapılan isteğin sonucunu bildirir.</td></tr><tr><td><strong>errorCode</strong></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen koddur.</td></tr><tr><td><strong>errorMessage</strong></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen mesajdır.</td></tr><tr><td><strong>errorGroup</strong></td><td>String</td><td>İşlem hatalıysa, bu hataya dair belirtilen gruptur.</td></tr><tr><td><strong>locale</strong></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><strong>systemTime</strong></td><td>Integer</td><td>Dönen sonucun o anki unix timestamp değeridir.</td></tr><tr><td><strong>conversationId</strong></td><td>String</td><td>İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.</td></tr><tr><td><strong>deepLinkUrl</strong></td><td>String</td><td>Ceppos app'ini uyandırmak için kullanılan link.</td></tr><tr><td><strong>paymentSessionToken</strong></td><td>String</td><td>İşlem başlatılırken kullanılan benzersiz id'dir.</td></tr></tbody></table>

#### **Yanıt Örneği**

```json
{
    "status": "success",
    "errorCode": null,
    "errorMessage": null,
    "errorGroup": null,
    "locale": null,
    "systemTime": 1724242498134,
    "conversationId": null,
    "deepLinkUrl": "https://www.iyzico.com/payment?paymentSessionToken=5D5BFC5E336EA9F9",
    "paymentSessionToken": "5D5BFC5E336EA9F9",
}
```

Yanıtta yer alan **deepLinkUrl** parametre değeri ile cihazınızda yüklü olan Ceppos uygulamasını uyandırarak iptal / iade işleminizi başlatabilirsiniz.

İşlem tamamlandığında headersta iletilen **x-callback-url** değerindeki linke yönlendirme olacaktır. Bu link ile sonucu sorgulayabilirsiniz.


---

# 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/urunler/ceppos-app2app/app2app-entegrasyonu/iptal-iade.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.