> 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/android-pos-web-api/islem-iptal-servisi.md).

# İşlem İptal Servisi

**Android Pos İşlem İptal Servisi**

Android Pos İşlem İptal Servisi; başarılı olarak tamamlanan işlemlerin iptal edilebilmesi için kullanılan servistir.

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

Servise gönderilmesi gereken parametreler şu şekildedir;

Android Pos Ödeme Servisi İstek Mesajı Parametreleri<br>

**Config**

<table><thead><tr><th width="219">Parametre</th><th width="88">Tip</th><th width="93">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>BACK_URL</td><td>string</td><td>Evet</td><td>İşlem sonuç cevabının sistem tarafından döndürüleceği adres bilgisidir. İşlem cevabı üye iş yeri tarafından bu adresten okunacaktır. İşlem sonucu form post olarak gönderilir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Evet</td><td>Üye iş yeri tarafından verilecek referans numarası bilgisidir. Ödeme işlemleri bu referans numarası ile takip edilebilir. Maksimum 24 karakter kullanılabilir.</td></tr></tbody></table>

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

```json
                                            
{
        "MERCHANT": "TEST1234",
        "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
        "BACK_URL": "https://posservicetest.esnekpos.com/api/home/PhysicalPaymentLog",
        "ORDER_REF_NUMBER": "ORDER_REF_NUMBER"
}
                                            
                                        
```

**Android Pos İşlem İptal Servisi Cevap Mesajı;**

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

Android Pos Ödeme Servisi İstek Mesajı Parametreleri<br>

**Config**

<table><thead><tr><th width="232">Parametre</th><th width="83">Tip</th><th width="81">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>Sorgulama işlemi sonucu durumu kod bilgisi.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>Sorgulama işlemi sonucu durum mesajı bilgisi.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Durum bilgisidir.</td></tr><tr><td>ORDER_REF_NUMBER</td><td>string</td><td>Evet</td><td>Üye iş yeri tarafından verilecek referans numarası bilgisidir. Ödeme işlemleri bu referans numarası ile takip edilebilir. Maksimum 24 karakter kullanılabilir.</td></tr><tr><td>REFNO</td><td>string</td><td>Evet</td><td>Ödeme işlemine ait hoppa sistemi tarafından verilen referans numarası bilgisi</td></tr></tbody></table>

```json
                                            
{
        "RETURN_CODE": "0",
        "RETURN_MESSAGE": null,
        "STATUS": "SUCCESS",
        "ORDER_REF_NUMBER": "ORDER_REF_NUMBER",
        "REFNO": "REFNO"
}
                                            
                                        
```

Android pos işlem iptal servisi cevap mesajında `STATUS` parametresinin değeri **SUCCESS** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi Android Pos işlem iptal servisinin başarılı olarak gerçekleştiğini ifade etmektedir.

Servisten dönebilecek Status bilgileri;

<table><thead><tr><th width="81.33333333333331">RETURN_CODE</th><th>STATUS</th><th>Açıklama</th></tr></thead><tbody><tr><td>0</td><td>SUCCESS</td><td>Başarılı işlemdir.</td></tr><tr><td>100</td><td>ERROR</td><td>Hatalı işlemdir.</td></tr><tr><td>102</td><td>AUTHENTICATION_ERROR</td><td>Kimlik doğrulama hatası.</td></tr><tr><td>105</td><td>INSERT_ERROR</td><td>Veritabanı kayıt işlemlerinde karşılaşılan hatalarda bu mesaj dönmektedir.</td></tr><tr><td>300</td><td>ORDER_CANCEL</td><td>Ödeme iptal servisinde oluşan hatalarda bu mesaj dönmektedir.</td></tr><tr><td>999</td><td>UNKNOWN_ERROR</td><td>Beklenmeyen bir hata gerçekleşti.</td></tr></tbody></table>