# İade/İptal Servisi

**İade/İptal Servisi İstek Modeli;**

<table><thead><tr><th width="115.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>

Servise gönderilmesi gereken parametreler şu şekildedir;

<table><thead><tr><th width="217">Parametre</th><th width="117">Tip</th><th width="98">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>MERCHANT</td><td>string</td><td>Evet</td><td>Üye iş yerine özel oluşturulan eşsiz kimlik bilgisidir.</td></tr><tr><td>MERCHANT_KEY</td><td>string</td><td>Evet</td><td>Üye iş yerine özel oluşturulan anahtar bilgisidir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Evet</td><td>Üye iş yeri 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>int</td><td>Evet</td><td>İşlem yapılmak istenen referans numarasına ait İptal/İade tutar bilgisidir.</td></tr><tr><td>SYNC_WITH_POS</td><td>bool</td><td>Hayır</td><td>Ödemenin iade/iptal işlemini banka ile senkron bir şekilde gerçekleştirmenizi sağlayacak parametredir.<br>False yollamanız durumunda anlık olarak banka tarafından onaylanmayan iade/iptal talebiniz sistemimize kaydedilir ve daha sonrasında operasyon birimimiz tarafından işleminiz tamamlanır.</td></tr></tbody></table>

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

```json
                                            
{
      "MERCHANT": "TEST1234" , 
      "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==" ,
      "ORDER_REF_NUMBER" : "0.54251300 1595848596|93" ,
      "AMOUNT": 29.99,
      "SYNC_WITH_POS": false,
}
                                        
```

**İade/İptal Servisi Cevap Mesajı;**

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

<table><thead><tr><th width="203">Parametre</th><th width="114">Tip</th><th width="110">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 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 EsnekPos sistemi tarafından verilen referans numarası bilgisidir.</td></tr><tr><td>TRANSACTION_ID</td><td>int</td><td>Evet</td><td>İade işlemi kart bankası tarafından anlık olarak onaylanırsa EsnekPos sistemi tarafında ödemenin alt işlemlerine eklenen kaydın referans numarası bilgisidir.</td></tr></tbody></table>

```json
                                            
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "29,99 ₺ iade talebiniz başarıyla kaydedilmiştir.",
    "STATUS": "SUCCESS",
    "ORDER_REF_NUMBER": null,
    "REFNO": null,
    "TRANSACTION_ID": null
}
                                        
```

İade/iptal işlem cevap mesajında `STATUS` parametresinin değeri **SUCCESS** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi İade/iptal İşleminin başarılı olarak gerçekleştiğini ifade etmektedir.