> For the complete documentation index, see [llms.txt](https://doc.paynet.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.paynet.com.tr/uornek/servisler/iptal-iade/iade.md).

# İade Talebi

Başarılı kredi kartı işlemlerinin iptali, iadesi veya kısmi iadesi talebi için kullanılır. Burada önemli olan nokta işlemin yapıldığı tarihtir. Aynı gün yapılan işlemler tüm tutar iptal edilir. Geçmiş tarihli işlemler tümü iade olabilir ya da kısmı iade yapabilirsiniz. Aynı gün yapılan işlemlerde kısmi iade yapılamaz.

{% hint style="info" %}
Bu servis ile işlem'in iptal/iade'si için Paynet sisteminde bir talep oluşturulur. Operasyon ekibi bu talebi inceler ve uygun gördüğü takdirde işlemi gerçekleştirir.
{% endhint %}

{% hint style="info" %}
 Ödeme servisini kullanabilmeniz için secret\_key ile basic authentication yapmalısınız. [bnkz](https://doc.paynet.com.tr/~/drafts/-LVM8pMcgdJBFmKMmegC/primary/authentication#secret-key).
{% endhint %}

{% hint style="success" %}
<https://api.paynet.com.tr/v1/transaction/reversed_request>
{% endhint %}

{% tabs %}
{% tab title="İstek Parametreleri" %}

| Parametre İsmi | Tip    | Zorunlu | Açıklama                                                                                                                                                                           |
| -------------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **xact\_id**   | string | Evet    | Paynet işlem numarası                                                                                                                                                              |
| **amount**     | string | Hayır   | İade edilecek tutar. İade edilecek tutarının yüz ile çarpılmış hali. “10.00 TL” => “1000” olarak gönderilmeli. Eğer gönderilmez ya da 0 gönderilirse tüm işlem tutarı iade edilir. |
| **succeedUrl** | string | Hayır   | İade talebi onaylandığında veya onaydan kaldırıldığında succeedUrl adresine durumuyla ilgili post işlemi yapılır.                                                                  |
| {% endtab %}   |        |         |                                                                                                                                                                                    |

{% tab title="Dönüş Parametreleri" %}

| Parametre İsmi   | Tip    | Açıklama                                                                             |
| ---------------- | ------ | ------------------------------------------------------------------------------------ |
| **object\_name** | string | Dönüş yapılan API’nin nesne adı                                                      |
| **code**         | string | Dönüş sonucunun kodu. [Bknz](/uornek/genel-bilgiler/hata-kodlari/doenues-kodlari.md) |
| **message**      | string | Dönüş sonuç kodunun açıklaması                                                       |
| {% endtab %}     |        |                                                                                      |

{% tab title="Request" %}

```
{
xact_id: "xk_EAAAAAh7VYf9HG4+GR9ezqiMWAA8PY6P4eroE4BUUHRCLxGO"
}
```

{% endtab %}

{% tab title="Response" %}

```
{  
   "object_name":"transaction_reversed_request",
   "message":"Başarılı İşlem",
   "code":0
}
```

{% endtab %}

{% tab title="Service Url" %}

| Sistem           | URL                                                              |
| ---------------- | ---------------------------------------------------------------- |
| **Canlı Sistem** | <https://api.paynet.com.tr/v1/transaction/reversed_request>      |
| **Test Sistemi** | ​<https://pts-api.paynet.com.tr/v1/transaction/reversed_request> |
| {% endtab %}     |                                                                  |
| {% endtabs %}    |                                                                  |

**succeedUrl Adresine Post Edilen Parametreler**

İade işlemi servisinden gelen talep doğrultusunda istenilen iadenşn onayı veya reddi durumunda, iade işlemi (v1/transaction/reversed\_request) servisinde belirtilen succeedUrl parametresinde belirtilen adrese JSON formatında post edilir. Eğer bu parametre boş değere sahip ise post işlemi gerçekleşmez.

#### `İstek Parametreleri`

| Parametre İsmi | Tip    | Açıklama                                                                                  |
| -------------- | ------ | ----------------------------------------------------------------------------------------- |
| **xact\_id**   | string | İade işleminin Paynet işlem numarası                                                      |
| **code**       | string | İade işleminin sonuç kodu 0: iade/iptal isteği onaylandı 1: iade/iptal isteği onaylanmadı |
| **status**     | string | İade işlemi sonucu ile ilgili durum statusu                                               |
| **message**    | string | İade işlemi sonucu ile ilgili not                                                         |