> For the complete documentation index, see [llms.txt](https://developer.esnekpos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esnekpos.com/hoppa-gelistirici-ortami/pazaryeri-entegrasyonu/iade-talebi.md).

# İade Talebi

**Pazaryeri İade Talebi Servisi İstek Modeli;**

<table><thead><tr><th width="107.33333333333331">Metod</th><th width="502">API URL</th><th>Parametreler</th></tr></thead><tbody><tr><td>POST</td><td>https://base-url/api/services/OrderReturn</td><td>JSON File</td></tr></tbody></table>

İade talebinde hangi magazaya ait ödemenin iade olması gerektiğini belirtmek için SubMerchantDetails alanı doldurulmalıdır.

Servise gönderilmesi gereken parametreler şu şekildedir;

<table><thead><tr><th width="214">Parametre</th><th width="87">Tip</th><th width="73">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>MERCHANT</td><td>string</td><td>Evet</td><td>Üye iş yerine(Pazaryeri) özel oluşturulan eşsiz kimlik bilgisidir.</td></tr><tr><td>MERCHANT_KEY</td><td>string</td><td>Evet</td><td>Üye iş yerine(Pazaryeri) özel oluşturulan anahtar bilgisidir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>int</td><td>Evet</td><td>Üye iş yeri(Pazaryeri) tarafından ödeme işlemi isteği gönderilirken verilmiş olan referans numarası bilgisidir. İptal edilecek ödeme işlemi ilgili üye iş yerine ait belirtilen referans numarası ile eşleştirilerek işlem gerçekleştirilir.</td></tr><tr><td>AMOUNT</td><td>string</td><td>Evet</td><td>İşlem yapılmak istenen referans numarasına ait İptal/İade tutar bilgisidir.</td></tr><tr><td>EXTERNAL_ID</td><td>string</td><td>Evet</td><td>Mağaza(submerchant)'nın pazaryeri(merchant) sistemindeki ID bilgisidir. Bu bilgi pazaryeri tarafından atanmaktadır.</td></tr><tr><td>AMOUNT</td><td>string</td><td>Evet</td><td>Mağaza(submerchant)'dan kesilecek tutar bilgisidir.</td></tr></tbody></table>

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

```json
                                            
{
    "MERCHANT": "TEST1234",
    "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
    "ORDER_REF_NUMBER": "412",
    "AMOUNT": "5",
    "SubMerchantDetails":[{  
      "EXTERNAL_ID":"EXTERNAL_ID1",
      "AMOUNT":"5.00" 
     }]
}
                                        
```

**Pazaryeri İade Talebi Servisi Cevap Mesajı;**

Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir;

<table><thead><tr><th width="224">Parametre</th><th width="119">Tip</th><th width="102">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>İade işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>İade işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>İade işlemi sonucu durum bilgisidir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Evet</td><td>Üye iş yeri(Pazaryeri) tarafından ödeme isteğinde, isteğe ait verilen referans numarası bilgisidir.</td></tr><tr><td>REFNO</td><td>string</td><td>Evet</td><td>İade işlemine ait hoppa sistemi tarafından verilen referans numarası bilgisidir.</td></tr></tbody></table>

```json
                                            
{
    "RETURN_CODE": "00",
    "RETURN_MESSAGE": "₺5,00 iade talebiniz alınmıştır.",
    "STATUS": "ORDER_CANCEL",
    "ORDER_REF_NUMBER": 412,
    "REFNO": null
}
                                        
```

Pazaryeri iade talebi cevap mesajında `STATUS` parametresinin değeri **ORDER\_CANCEL** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi onaylama işleminin başarılı olarak gerçekleştiğini ifade etmektedir.