> 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/magaza-alacak-azaltma.md).

# Mağaza Alacak Azaltma

**Mağaza Alacak Azaltma Servisi İstek Modeli;**

<table><thead><tr><th width="95.33333333333331">Metod</th><th width="540">API URL</th><th>Parametreler</th></tr></thead><tbody><tr><td>POST</td><td>http://base-url/api/services/AddSubMerchantAmount</td><td>JSON File</td></tr></tbody></table>

Tahsilat esnasından iletilen mağazanın(submerchant) alacaklı olduğu tutar, sonradan azaltılabilir.

Servise gönderilmesi gereken parametreler şu şekildedir;

<table><thead><tr><th width="219">Parametre</th><th width="83">Tip</th><th width="97">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>string</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>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>int</td><td>Evet</td><td>İşlem yapılmak istenen referans numarasına ait azaltılmak istenen 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",
    "EXTERNAL_ID": "EXTERNAL_ID1",
    "AMOUNT": -5
}
                                        
```

**Mağaza Alacak Azaltma Servisi Cevap Mesajı;**

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

<table><thead><tr><th width="249">Parametre</th><th width="87">Tip</th><th width="99">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>Alacak azaltma işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>Alacak azaltma işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Alacak azaltma 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>Alacak azaltma işlemine ait hoppa sistemi tarafından verilen referans numarası bilgisidir.</td></tr></tbody></table>

```json
                                            
{
    "RETURN_CODE": "00",
    "RETURN_MESSAGE": "5,00 ₺ alt mağaza alacağına eklenmiştir.",
    "STATUS": "SUCCESS",
    "ORDER_REF_NUMBER": 412,
    "REFNO": null
}
                                        
```

Mağaza alacak azaltma talebi cevap mesajında `STATUS` parametresinin değeri **SUCCESS** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi azaltma işleminin başarılı olarak gerçekleştiğini ifade etmektedir.