# İ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.