> 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/tekrarli-odeme-servisi/islem-listeleme-servisi.md).

# İşlem Listeleme Servisi

**İşlem Listeleme Servisi İstek Modeli;**

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

Servise gönderilmesi gereken parametreler şu şekildedir;

\
İşlem Listeleme Servisi İstek Mesajı Parametreleri

<table><thead><tr><th width="184">Parametre</th><th width="86">Tip</th><th width="86">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>START_DATE</td><td>string</td><td>Evet</td><td>Sorgu için başlangıç tarih bilgisidir.</td></tr><tr><td>END_DATE</td><td>string</td><td>Evet</td><td>Sorgu için bitiş tarih bilgisidir.</td></tr></tbody></table>

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

```json
                                            
{
    "MERCHANT": "TEST1234", 
    "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==",
    "START_DATE" : "01-12-2021",
    "END_DATE" : "05-07-2022"
}
                                        
```

**İşlem Listeleme Servisi Cevap Mesajı;**

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

\
İşlem Listeleme Servisi Cevap Mesajı Parametreleri

<table><thead><tr><th width="238">Parametre</th><th width="81">Tip</th><th width="73">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme listeleme işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme listeleme işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme listeleme işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>RECURRING_PAYMENTS</td><td>array</td><td>Evet</td><td></td></tr></tbody></table>

<br>

**RECURRING\_PAYMENTS**

<table><thead><tr><th width="213">Parametre</th><th width="84">Tip</th><th width="73">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>ID</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme id bilgisi</td></tr><tr><td>DATE</td><td>string</td><td>Evet</td><td>Ödeme işlemi için işlem tarihi bilgisidir.</td></tr><tr><td>RECURRING_COUNT</td><td>string</td><td>Evet</td><td>Tekrar sayısı</td></tr><tr><td>TRY_COUNT_LIMIT</td><td>int</td><td>Evet</td><td>Tekrarı deneme sayısı</td></tr><tr><td>AMOUNT</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme tutar bilgisi</td></tr><tr><td>CURRENCY</td><td>string</td><td>Evet</td><td>Tekrarlı ödeme işlemi para birimidir.('TRY','USD','EUR')</td></tr><tr><td>SUCCES_COUNT</td><td>string</td><td>Evet</td><td>Tekrarlı ödemeye ait başarılı tekrar sayısı bilgisi</td></tr><tr><td>DEALER_REF_NO</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.</td></tr><tr><td>CUSTOMER_GSM</td><td>string</td><td>Evet</td><td>Müşteri telefon bilgisidir.</td></tr><tr><td>CUSTOMER_EMAIL</td><td>string</td><td>Evet</td><td>Müşteri email bilgisidir.</td></tr><tr><td>COSTUMER_NAME</td><td>string</td><td>Evet</td><td>Müşteri isim bilgisidir.</td></tr><tr><td>COSTUMER_ADRESS</td><td>string</td><td>Evet</td><td>Müşteri adres bilgisidir.</td></tr></tbody></table>

<br>

**RECURRING\_PAYMENT\_TRANSACTIONS**

<table><thead><tr><th width="177">Parametre</th><th width="97">Tip</th><th width="81">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RECURRING_NO</td><td>int</td><td>Evet</td><td>N. tekrar</td></tr><tr><td>PAYMENT_DATE</td><td>string</td><td>Evet</td><td>Tekrarın çekileceği tarih</td></tr><tr><td>REF_NO</td><td>int</td><td>Evet</td><td>Tekrara ait referans numarası bilgisi. Ödeme işlemi sorgulama ve tekrar iptal etme servisinde kullanılabilir.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Durum bilgisi.</td></tr><tr><td>TRIES_COUNT</td><td>string</td><td>Evet</td><td>Tekrarın denenme sayısı.</td></tr><tr><td>SUCCES_DATE</td><td>string</td><td>Evet</td><td>Tekrarın başarılı olduğu tarih.</td></tr><tr><td>PAYMENT_ID</td><td>array</td><td>Evet</td><td>Tekrar başarılı ise ödeme id bilgisi.</td></tr><tr><td>IS_ACTIVE</td><td>array</td><td>Evet</td><td>Tekrarın aktiflik durumu</td></tr></tbody></table>

<br>

**RECURRING\_PAYMENT\_TRIES**

<table><thead><tr><th width="166">Parametre</th><th width="89">Tip</th><th width="77">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>PAYMENT_ID</td><td>string</td><td>Evet</td><td>Ödeme id bilgisi.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Tekrar deneme durumu.</td></tr><tr><td>DESCRIPTION</td><td>string</td><td>Evet</td><td>Tekrar denemesine ait açıklama.</td></tr><tr><td>TRY_DATE</td><td>string</td><td>Evet</td><td>Tekrar denemesinin yapıldığı tarih.</td></tr></tbody></table>

```json
                                            
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "SUCCESS",
    "STATUS": "SUCCESS",
    "RECURRING_PAYMENTS": [
        {
            "ID": 343666,
            "DATE": "24.06.2022",
            "RECURRING_COUNT": "10",
            "TRY_COUNT_LIMIT": "5",
            "AMOUNT": "1250,00",
            "CURRENCY": "TRY",
            "SUCCESS_COUNT": "3",
            "DEALER_REF_NO": "ORDER_REF_NUMBER",
            "COSTUMER_GSM": "5553332211",
            "COSTUMER_EMAIL": "test@test.com",
            "COSTUMER_NAME": "TEST USER",
            "COSTUMER_ADRESS": "TEST ADRESS",
            "RECURRING_PAYMENT_TRANSACTIONS": [
                { 
                "RECURRING_NO": 1,
                "PAYMENT_DATE": "24.06.2022",
                "REF_NO": "REF_NO_1",
                "STATUS": "Başarılı",
                "TRIES_COUNT": "1",
                "SUCCESS_DATE": "24.06.2022",
                "PAYMENT_ID": "343312",
                "IS_ACTIVE": "true",
                "RECURRING_PAYMENT_TRIES ": [
                        {
                        "PAYMENT_ID": "343312",
                        "STATUS": "Başarılı",
                        "DESCRIPTION": "Başarılı"
                        "TRY_DATE": "24.06.2022"
                        }
                    ]
                },
                { 
                "RECURRING_NO": 2,
                "PAYMENT_DATE": "24.07.2022",
                "REF_NO": "REF_NO_2",
                "STATUS": "Bekliyor",
                "TRIES_COUNT": "0",
                "SUCCESS_DATE": null,
                "PAYMENT_ID": null,
                "IS_ACTIVE": "true",
                "RECURRING_PAYMENT_TRIES ": []
                }
            ]
        }
    ]
}
                                            
                                        
```

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