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

# Mağaza Sorgulama

**Pazaryeri Mağaza Tanımlama ve Güncelleme Servisi İstek Modeli;**

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

Servise gönderilmesi gereken parametreler şu şekildedir;

Pazaryeri Mağaza Sorgulama İstek Mesajı Parametreleri

<table><thead><tr><th width="243">Parametre</th><th width="80">Tip</th><th width="95">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>EXTERNAL_ID</td><td>string</td><td>Evet</td><td>Mağaza(submerchant)'nın pazaryerin(merchant) sistemindeki ID bilgisidir. Bu bilgi pazaryeri tarafından atanmaktadır. Diğer istek paremetrelerinde kullanılacak bu mağazanın unique bilgisi bu bilgidir.</td></tr></tbody></table>

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

```
{
   "MERCHANT":"TEST1234",
   "MERCHANT_KEY":"4oK12326hK8MOXrIV1bzTRVPA==",
   "EXTERNAL_ID":"a5s1239f6465s1-s164g4r6q"
}
```

Pazaryeri Mağaza Sorgulama Cevap Mesajı;

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

<table><thead><tr><th width="240">Parametre</th><th width="78">Tip</th><th width="96">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>STATUS</td><td>string</td><td>Evet</td><td>Ödeme işlemi sonucu durum bilgisidir.</td></tr><tr><td>RETURN_CODE</td><td>string</td><td>Evet</td><td>Ödeme işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>RETURN_MESSAGE</td><td>string</td><td>Evet</td><td>Ödeme işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>SUBMERCHANT_DETAIL</td><td>array</td><td>Evet</td><td>Mağaza(submerchant) sahibinin detay bilgisidir.</td></tr></tbody></table>

**SUBMERCHANT DETAIL**

<table><thead><tr><th width="244">Parametre</th><th width="82">Tip</th><th width="100">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>NAME</td><td>string</td><td>Evet</td><td>Üye iş yerine(Pazaryeri) ait isim bilgisidir.</td></tr><tr><td>OWNER_NAME</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) sahibinin ad bilgisidir.</td></tr><tr><td>OWNER_SURNAME</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) sahibinin soyad bilgisidir.</td></tr><tr><td>OWNER_IDENTITY_NUMBER</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) sahibinin T.C. Kimlik Numarası bilgisidir.</td></tr><tr><td>EMAIL</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) sahibinin e-mail bilgisidir.</td></tr><tr><td>GSM</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) sahibinin telefon bilgisidir.</td></tr><tr><td>COMPANY_NAME</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) ad bilgisidir.</td></tr><tr><td>TAX_OFFICE</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) vergi dairesi bilgisidir.</td></tr><tr><td>TAX_NUMBER</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) vergi numarası bilgisidir.</td></tr><tr><td>BANK_NAME</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) için ödemelerin yapılacağı hesaba ait hesap sahibinin adı veya şirketin ad bilgisidir.</td></tr><tr><td>TYPE</td><td>string</td><td>Evet</td><td>Mağaza(submerchant)'nın pazaryerin(merchant)deki tip bilgisidir. PERSONAL veya PERSONAL_COMPANY veya COMPANY olarak tanımlanacaktır. Şahıs olarak satış yapan mağazalar için PERSONAL, Şahıs şirketleri için PERSONAL_COMPANY, Şirketler için COMPANY seçeneği seçilmelidir.</td></tr><tr><td>IS_ACTIVE</td><td>bool?</td><td>Evet</td><td>Mağaza(submerchant) için aktiflik durum bilgisidir.</td></tr></tbody></table>

```
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "SUCCESS",
    "STATUS": "SUCCESS",
    "MERCHANT_DETAIL": {
        "NAME": "ELEKSE",
        "OWNER_NAME": "TEST NAME",
        "OWNER_SURNAME": "TEST SURNAME",
        "OWNER_IDENTITY_NUMBER": "12345678910",
        "EMAIL": "info@elekse.com",
        "GSM": "5345552583",
        "COMPANY_NAME": "ELEKSE ÖDEME KURULUŞU VE PARA A.Ş.",
        "TAX_OFFICE": "Kağıthane",
        "TAX_NUMBER": "",
        "BANK_NAME": "kuveytturk",
        "TYPE": "PERSONAL",
        "IS_ACTIVE": true,
        "BANK_ACCOUNTS": [
            {
                "IBAN": "TR111111111111111111111111",
                "CURRENCY": "TRY"
            }
        ]
    }
}
```

İşlem durum sorgulama cevap mesajında `STATUS` parametresinin değeri **SUCCESS** ve `RETURN_CODE` parametresinin değeri **0** olarak dönmesi işlem durum sorgulamasının başarılı olarak gerçekleştiğini ifade etmektedir.&#x20;


---

# 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/pazaryeri-entegrasyonu/magaza-sorgulama.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.