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

# Mağaza Tanımlama

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

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

Servise gönderilmesi gereken parametreler şu şekildedir;

Pazaryeri Mağaza Tanımlama ve Güncelleme Servisi İstek Mesajı Parametreleri

<table><thead><tr><th width="270">Parametre</th><th width="90">Tip</th><th width="80">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>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>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><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>IBAN</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) için banka hesabına ait IBAN bilgisidir.</td></tr><tr><td>CURRENCY</td><td>string</td><td>Evet</td><td>Mağaza(submerchant) için banka hesabına ait para birimi bilgisidir. Şu an için sadece “TRY, USD, EUR, GBP” gönderilebilir.</td></tr></tbody></table>

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

```json
{
   "MERCHANT":"TEST1234",
   "MERCHANT_KEY":"4oK26hK8MOXrIV1bzTRVPA==",
   "NAME":"NAME",
   "OWNER_NAME":"OWNER_NAME",
   "OWNER_SURNAME":"OWNER_SURNAME",
   "OWNER_IDENTITY_NUMBER":"12365478912",
   "EMAIL":"abc@domain.com",
   "GSM":"5435434343",
   "COMPANY_NAME":"COMPANY_NAME",
   "TAX_OFFICE":"TAX_OFFICE",
   "TAX_NUMBER":"TAX_NUMBER",
   "BANK_NAME":"ACCOUNT OWNER NAME",
   "EXTERNAL_ID":"a5s9f6465s1-s164g4r6q",
   "TYPE":"PERSONAL_COMPANY",
   "BANK_ACCOUNTS":[
      {
         "IBAN":"TR123456789123456789123456",
         "CURRENCY":"TRY"
      },
      {
         "IBAN":"TR123456789123456789123468",
         "CURRENCY":"USD"
      }
   ]
}
```

**Pazaryeri Mağaza Tanımlama ve Güncelleme Servisi Cevap Mesajı;**

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

<table><thead><tr><th width="205">Parametre</th><th width="100">Tip</th><th width="90">Zorunlu</th><th>Açıklama</th></tr></thead><tbody><tr><td>Data</td><td>string</td><td>Evet</td><td>Tanımlama veya Güncelleme işlemine ait veri bilgisidir.</td></tr><tr><td>ResultCode</td><td>string</td><td>Evet</td><td>Tanımlama veya Güncelleme işlemi sonucu durumu kod bilgisidir.</td></tr><tr><td>ResultMessage</td><td>string</td><td>Evet</td><td>Tanımlama veya Güncelleme işlemi sonucu durum mesaj bilgisidir.</td></tr><tr><td>Exception</td><td>string</td><td>Evet</td><td>Tanımlama veya Güncelleme işlemi için işlem sırısında gerçekleşen istisna durum bilgisidir.</td></tr></tbody></table>

```json
                                            
{
    "Data": null,
    "ResultCode": "00",
    "ResultMessage": "SUCCESS",
    "Exception": null
}
                                        
```

Mağaza Tanımlama ve Güncelleme cevap mesajında `ResultMessage` parametresinin değeri **SUCCESS** ve `ResultCode` parametresinin değeri **0** olarak dönmesi tanımlama veya güncelleme işleminin 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:

```
GET https://developer.esnekpos.com/hoppa-gelistirici-ortami/pazaryeri-entegrasyonu/magaza-tanimlama.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.