---
title: Mağaza kredisi
description: Müşterilerin mağaza kredisi bakiyelerini sorgulayın ve güncelleyin.
full: true
---

## Mağaza kredilerini listele [#listStoreCredit]

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

Bir müşteriye ait mağaza kredisi (store credit) kayıtlarını listeler. Her satış kanalı / storefront satırı ayrı döner; kalan bakiyeler toplanmaz. Silinmiş kayıtlar ve hediye kartı kayıtları dahil edilmez.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `customerId` (zorunlu) | `String!` |  |

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

Örnek istek - Müşterinin mağaza kredilerini listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Bir müşterinin mağaza kredisi kayıtlarını listeler. Kalan bakiye `amount - usedAmount` ile hesaplanır.

```graphql
query ListStoreCredit($customerId: String!) {
  listStoreCredit(customerId: $customerId) {
    id
    amount
    usedAmount
    usedAllAmount
    active
    startDate
    endDate
  }
}
```

```json
{
  "customerId": "c6024fb9-53d9-41a6-b37b-0b481d3428de"
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "listStoreCredit": [
      {
        "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "amount": 129.9,
        "usedAmount": 129.9,
        "usedAllAmount": true,
        "active": true,
        "startDate": 1735725600000,
        "endDate": 1735725600000
      }
    ]
  }
}
```

## Mağaza kredisi tutarını güncelle [#updateStoreCreditAmount]

**`updateStoreCreditAmount`** (mutation, v1 · v2)

Mağaza kredisinin kalan bakiyesini ayarlar. `amount` yeni bir toplam değil, hedeflenen kalan bakiyedir. Kullanılan tutar değişmez. Mevcut kalan bakiyeyi göndermek herhangi bir değişiklik yapmaz.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `UpdateStoreCreditAmountInput!` | İşlemin girdi nesnesi. |

Dönen değer: `StoreCredit!`

Örnek istek - Mağaza kredisi bakiyesini güncelleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Sadakat uygulaması kazanılan puanları krediye çevirdiğinde kalan bakiyeyi günceller. `amount` yeni toplam değil, hedeflenen kalan bakiyedir.

```graphql
mutation UpdateStoreCreditAmount($input: UpdateStoreCreditAmountInput!) {
  updateStoreCreditAmount(input: $input) {
    id
    amount
    usedAmount
    usedAllAmount
    active
    updatedAt
  }
}
```

```json
{
  "input": {
    "id": "87bf121b-d75f-4670-a68b-259f459c026f",
    "amount": 250
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "updateStoreCreditAmount": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "amount": 129.9,
      "usedAmount": 129.9,
      "usedAllAmount": true,
      "active": true,
      "updatedAt": 1735725600000
    }
  }
}
```