# İş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.