---
title: Mağaza bilgileri
description: Mağaza, lisans, ayar ve yetkili uygulama bilgilerini alın.
full: true
---

## MerchantResponse nesnesi [#MerchantResponse]

**`MerchantResponse`** (v1 · v2)

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `address` | `MerchantAddress` | Mağazanın adres bilgisi. |
| `email` | `String!` | Mağaza personelinin e-posta adresi. |
| `firstName` | `String!` | Mağaza sahibinin adı. |
| `id` | `String!` | Kaydın ID değeri. |
| `lastName` | `String!` | Mağaza sahibinin soyadı. |
| `merchantName` | `String` | Mağaza personelinin soyadı. |
| `merchantSequence` | `Float` |  |
| `phoneNumber` | `String` | Mağazanın telefon numarası. |
| `region` | `MerchantRegionEnum` | Mağaza personelinin soyadı. Değerler: `AF`, `AN`, `AS`, `EU`, `OC`, `PL`, `TR`, `US`. |
| `storeName` | `String` | Mağazanın adı. |
| `billingAddress` (yalnızca v1) | `MerchantAddress` | Mağazanın adres bilgisi. |

Örnek (temsili):

```json
{
  "address": {
    "addressLine1": "Örnek Mah. 1. Sok. No: 1",
    "addressLine2": "Örnek Mah. 1. Sok. No: 1",
    "city": null,
    "company": "Örnek Şirket",
    "country": null,
    "district": null,
    "firstName": "Ayşe",
    "identityNumber": "11111111111",
    "lastName": "Yılmaz",
    "postalCode": "34000",
    "state": null,
    "taxNumber": "1234567890",
    "taxOffice": "Kadıköy",
    "title": "Örnek",
    "type": "CORPORATE",
    "verified": true,
    "verifiedAt": 1735725600000,
    "vkn": "string"
  },
  "email": "musteri@ornek.com",
  "firstName": "Ayşe",
  "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
  "lastName": "Yılmaz",
  "merchantName": "Örnek",
  "merchantSequence": 1,
  "phoneNumber": "+905551112233",
  "region": "AF",
  "storeName": "Örnek"
}
```

## Mağaza bilgilerini getir [#getMerchant]

<Callout type="info" title="v2'de mağaza sahibi bilgileri">
Mağaza sahibinin kişisel bilgileri dış uygulamalarla paylaşılmaz. v2'de `firstName`, `lastName` ve `email` alanları boş metin, `address` alanı `null` döner.
</Callout>

**`getMerchant`** (query, v1 · v2)

Bu API ile mağazanın ve mağaza personelinin özelliklerini alabilirsiniz.

Parametreler:

_Parametre yok._

Dönen değer: `MerchantResponse!`

Örnek istek - Mağazanın temel bilgilerini getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Uygulamanın kurulu olduğu mağazanın ID, mağaza adı ve bölge bilgisini döndürür. Mağaza sahibinin kişisel bilgileri v2'de boş döner; bu yüzden örnekte istenmez.

```graphql
query GetMerchant {
  getMerchant {
    id
    storeName
    merchantName
    merchantSequence
    region
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "getMerchant": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "storeName": "Örnek",
      "merchantName": "Örnek",
      "merchantSequence": 1,
      "region": "AF"
    }
  }
}
```

Örnek istek - Mağaza bilgilerini getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  getMerchant {
    email
    firstName
    id
    lastName
    merchantName
    merchantSequence
    phoneNumber
    storeName
  }
}
```

Örnek yanıt:

```json
{
  "data": {
    "getMerchant": {
      "email": "",
      "firstName": "",
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "lastName": "",
      "merchantName": "Örnek Mağaza",
      "merchantSequence": 310,
      "phoneNumber": null,
      "storeName": "ornek"
    }
  }
}
```

## Mağaza lisanslarını getir [#getMerchantLicence]

**`getMerchantLicence`** (query, v1 · v2)

Mağazanın aktif paketini ve dönemini döner. `appSubscriptions` alanında yalnızca sizin uygulamanıza ait abonelikler bulunur.

Parametreler:

_Parametre yok._

Dönen değer: `MerchantLicenceResponse!` (v1: `MerchantLicence!`)

Örnek istek - Mağaza lisansını getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Mağazanın aktif ikas paketini, lisans tarihlerini ve uygulamanızın bu mağazadaki aboneliklerini döndürür. Uygulamanız, kendi aboneliğinin durumunu kontrol ederek özellikleri açıp kapatmak için kullanabilir.

```graphql
query GetMerchantLicence {
  getMerchantLicence {
    merchantId
    activeSubscriptionCode
    period
    fromDate
    toDate
    appSubscriptions {
      storeAppId
      name
      status
      storeAppListingSubscriptionKey
      lastPaymentPeriod
      lastPaymentDate
    }
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "getMerchantLicence": {
      "merchantId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "activeSubscriptionCode": "CUSTOM",
      "period": "MONTHLY",
      "fromDate": 1735725600000,
      "toDate": 1735725600000,
      "appSubscriptions": [
        {
          "storeAppId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
          "name": "Örnek",
          "status": "ACTIVE",
          "storeAppListingSubscriptionKey": "string",
          "lastPaymentPeriod": "MONTHLY",
          "lastPaymentDate": 1735725600000
        }
      ]
    }
  }
}
```

## Mağaza ayarlarını getir [#getMerchantSettings]

**`getMerchantSettings`** (query, v2)

Mevcut mağazanın para birimi kodu, saat dilimi, varsayılan dil ve para birimi formatları dahil mağaza ayarlarını getirir. Bulunamazsa hata döner.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

_Parametre yok._

Dönen değer: `MerchantSettingsResponse!`

Örnek istek - Mağazanın varsayılan para birimini alma (`POST https://api.myikas.com/api/v2/admin/graphql`):

Mağazanın varsayılan para birimini ve fiyatların nasıl biçimlendirileceğini döndürür. Fatura veya pazaryeri entegrasyonunda tutarları mağazanın para birimiyle göstermek için kullanılır.

```graphql
query GetMerchantSettings {
  getMerchantSettings {
    merchantId
    currencyCode
    currencyFormats {
      currencyCode
      symbol
      symbolPosition
      decimalSeparator
      thousandSeparator
      omitZeroDecimal
    }
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "getMerchantSettings": {
      "merchantId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "currencyCode": "TRY",
      "currencyFormats": [
        {
          "currencyCode": "TRY",
          "symbol": "string",
          "symbolPosition": "LEFT",
          "decimalSeparator": "string",
          "thousandSeparator": "string",
          "omitZeroDecimal": true
        }
      ]
    }
  }
}
```

## Mağaza ayarlarını listele [#listMerchantSettings]

**`listMerchantSettings`** (query, v1)

Yalnızca v1 endpoint'inde: `https://api.myikas.com/api/v1/admin/graphql`. v2 karşılığı: `getMerchantSettings`.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |
| `merchantId` | `StringFilterInput` |  |

Dönen değer: `[MerchantSettings!]!`

Örnek istek - Mağaza ayarlarını listeleme (`POST https://api.myikas.com/api/v1/admin/graphql`):

v1 üzerinde mağaza adı, iletişim telefonu, para birimi, varsayılan dil ve saat dilimi gibi genel ayarları döndürür. v2 kullanıyorsanız `getMerchantSettings` query'sini tercih edin.

```graphql
query ListMerchantSettings {
  listMerchantSettings {
    id
    merchantName
    phone
    currencyCode
    currencySymbol
    defaultLocale
    timezone
    updatedAt
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "listMerchantSettings": [
      {
        "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "merchantName": "Örnek",
        "phone": "+905551112233",
        "currencyCode": "TRY",
        "currencySymbol": "₺",
        "defaultLocale": "string",
        "timezone": "string",
        "updatedAt": 1735725600000
      }
    ]
  }
}
```

## Yetkili uygulama bilgisini getir [#getAuthorizedApp]

**`getAuthorizedApp`** (query, v1 · v2)

Token'ın ait olduğu yetkili uygulama kaydını döner: uygulamaya verilen scope'lar, kurulum tarihi ve uygulama satış kanalıysa satış kanalı ID'si.

Parametreler:

_Parametre yok._

Dönen değer: `AuthorizedApp`

Örnek istek - Yetkili uygulama bilgisini getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  getAuthorizedApp {
    addedDate
    createdAt
    deleted
    id
    partnerId
    salesChannelId
    scope
    storeAppId
    supportsMultipleInstallation
    updatedAt
  }
}
```

Örnek yanıt:

```json
{
  "data": {
    "getAuthorizedApp": {
      "addedDate": 1637050545408,
      "createdAt": 1637050545409,
      "deleted": false,
      "id": "2529c556-ad9d-4699-9851-36d2f6976e70",
      "partnerId": "ddb72972-9b6c-4104-920b-3c4e5d07a92b",
      "salesChannelId": null,
      "scope": "read_customers,write_customers",
      "storeAppId": "d1fece9f-df40-4bf7-90c7-3996ecf5ae8f",
      "supportsMultipleInstallation": null,
      "updatedAt": 1637050545409
    }
  }
}
```

## Token sahibini getir [#me]

**`me`** (query, v1 · v2)

Parametreler:

_Parametre yok._

Dönen değer: `MeResponse`

Örnek istek - Token sahibini getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  me {
    addedDate
    email
    id
    name
    partnerId
    salesChannelId
    scope
    scopes
    storeAppId
    supportsMultipleInstallation
  }
}
```

Örnek yanıt:

```json
{
  "data": {
    "me": {
      "addedDate": 1637050545408,
      "email": null,
      "id": "2529c556-ad9d-4699-9851-36d2f6976e70",
      "name": null,
      "partnerId": "ddb72972-9b6c-4104-920b-3c4e5d07a92b",
      "salesChannelId": null,
      "scope": "read_customers,write_customers",
      "scopes": null,
      "storeAppId": "d1fece9f-df40-4bf7-90c7-3996ecf5ae8f",
      "supportsMultipleInstallation": null
    }
  }
}
```

## Dilleri listele [#listLanguage]

**`listLanguage`** (query, v1)

Yalnızca v1 endpoint'inde: `https://api.myikas.com/api/v1/admin/graphql`.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |

Dönen değer: `[Language!]!`

Örnek istek - Dilleri listeleme (`POST https://api.myikas.com/api/v1/admin/graphql`):

Çeviri veya çok dilli içerik uygulamalarında, ikas'ta desteklenen dilleri ve locale kodlarını almak için kullanılır.

```graphql
query ListLanguage {
  listLanguage {
    id
    name
    locale
    isFree
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "listLanguage": [
      {
        "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "name": "Örnek",
        "locale": "tr",
        "isFree": true
      }
    ]
  }
}
```