> 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-sorgulama-servisi.md).

# İşlem Sorgulama Servisi

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

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

Servise gönderilmesi gereken parametreler şu şekildedir;

İşlem Sorgulama Servisi İstek Mesajı Parametreleri

<table><thead><tr><th width="221">Parametre</th><th width="104">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>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.</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"
}
                                        
```

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

İşlem Sorgulama Servisi Cevap Mesajı Parametreleri

<table><thead><tr><th width="218">Parametre</th><th width="106">Tip</th><th width="94">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>İşlem sorgulama işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>İşlem sorgulama işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>STATUS</td><td>string</td><td>Evet</td><td>İşlem sorgulama işlemi sonucu durum bilgisidir.</td></tr><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="187">Parametre</th><th width="105">Tip</th><th width="99">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="92">Tip</th><th width="93">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>

İşlem Sorgulama Servisi Cevap Mesajı Parametreleri

```json
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "SUCCESS",
    "STATUS": "SUCCESS",
    "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 sorgulama servis cevap mesajında `STATUS` parametresinin değeri **SUCCESS** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi işlem sorgulama servisinin başarılı olarak gerçekleştiğini ifade etmektedir.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esnekpos.com/hoppa-gelistirici-ortami/tekrarli-odeme-servisi/islem-sorgulama-servisi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.