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