# Olay akışı ve türleri

`GET https://api.siparis.app/v1/events` kalıcı değişiklikleri yayın sırasıyla verir. Bearer anahtarında `events:read` yanında kaynağın okuma kapsamı da gerekir; örneğin sipariş olayında `orders:read`. Olaylar kişisel bilgi içermez, kaynağın güncel hali ilgili okuma ucundadır.

```bash
curl --fail-with-body --silent --show-error --get \
  "${SIPARIS_API_URL:-https://api.siparis.app/v1}/events" \
  -H "Authorization: Bearer $SIPARIS_API_KEY" \
  --data-urlencode 'limit=50'
```

Örnek HTTP 200 yanıtı (uydurma veri):

```json
{
  "data": [
    {
      "actor": {
        "type": "user"
      },
      "created_at": "2026-10-16T09:00:00Z",
      "data": {
        "changes": {
          "current": {},
          "previous": {}
        },
        "object": {
          "id": "ord_1234567890abcdef1234567890abcdef"
        }
      },
      "id": "evt_1234567890abcdef1234567890abcdef",
      "livemode": true,
      "schema_version": 1,
      "store": "sto_1234567890abcdef1234567890abcdef",
      "type": "order.created"
    }
  ],
  "has_more": false,
  "next_cursor": "SUNUCUDAN_DONEN_IMLEC"
}
```



Her yanıttaki `next_cursor` değerini işlenen olaylarla aynı veritabanı işleminde saklayın. Olayı `evt_…` kimliğiyle tekilleştirin; aynı sayfayı tekrar okumak tekrar iş etkisi oluşturmamalıdır. İşlem başarısızsa eski imleci koruyun. Akış ucundaki sıralamayı olay zamanından veya kimliğinden yeniden üretmeyin.

`data=[]` olsa bile `has_more=true` olabilir; yeni imleçle hemen devam edin. `has_more=false` olunca kısa bekleme ekleyip dönen imleçle yeniden sorun. Kaynak listelerinden farklı olarak son sayfanın `next_cursor` alanı null olmaz. Sürekli döngüde 429 için `Retry-After`, ağ/5xx için artan bekleme ve rastgele gecikme kullanın.

İlk aktarım için [tutarlı dışa aktarma](https://developer.siparis.app/ilk-esitleme) alın; dosyanın `resume_cursor` değeriyle devam edin. Bu imlece `types` eklemeyin. Bağımsız bir akışı daraltmak isterseniz ilk çağrıdan itibaren `types=order.created,order.status_changed` kullanabilirsiniz; aynı süzgeci bütün devam çağrılarında koruyun. `GET /v1/events/{id}` tek olayı verir.

Marka görünürlüğü olay anındaki bağa göre belirlenir. `inventory.low` güncel durumu bildirdiğinden kitlesi, stok ve eşikle aynı sorguda okunan güncel marka bağıdır. Ürünün markadan çıkarılması yayımlanmış geçmiş olayı başka markaya açmaz. `job.completed` ayrıca işi açan bağlantı ve kaynağın okuma kapsamıyla sınırlıdır.

## Olay türleri

Kalıcı olayları okumak için events:read ve kaynak kapsamı gerekir. webhook.test yalnız ilgili uca gönderilen denemedir; events akışına girmez. Alan: `Event.type`.

| Kod | Türkçe adı | Ne zaman |
| --- | --- | --- |
| `job.completed` | İş bitti | Dışa aktarma veya toplu fiyat/stok işi tamamlandı ya da başarısız oldu. Kapsam: exports:write, products:write, inventory:write. |
| `order.created` | Sipariş oluşturuldu | Vitrin, panel, AI, API veya pazaryerinden yeni sipariş geldi. Kapsam: orders:read. |
| `order.updated` | Sipariş değişti | Siparişin tutarı, kalemleri, adresi, notları veya alt kayıtları değişti. Kapsam: orders:read. |
| `order.status_changed` | Sipariş durumu değişti | Sipariş başka bir duruma geçti (ör. Onaylandı → Kargoda). Kapsam: orders:read. |
| `collection.recorded` | Ödeme alındı | Siparişe tahsilat yazıldı. Kapsam: payments:read. |
| `collection.reversed` | Ödeme geri alındı | Yanlış kaydedilen tahsilat ters kayıtla geri alındı. Kapsam: payments:read. |
| `refund.succeeded` | Para iade edildi | Müşteriye para iadesi tamamlandı. Kapsam: payments:read. |
| `payment.failed` | Kart ödemesi başarısız | PayTR veya iyzico kart denemesi kesin olarak reddedildi; aynı deneme yalnız bir kez bildirilir. Kapsam: payments:read. |
| `return.requested` | İade/değişim açıldı | Müşteri veya satıcı iade/değişim sürecini açtı. Kapsam: returns:read. |
| `return.approved` | İade/değişim onaylandı | Talep approved veya code_sent durumuna geçti; bu iki durum arasındaki kod değişikliği yeniden onay değildir. Kapsam: returns:read. |
| `return.rejected` | İade/değişim reddedildi | Talep declined durumuna geçti. Kapsam: returns:read. |
| `return.received` | İade ürünü geldi | Ürün ulaştı veya kontrol sonucu kaydedildi; ilk teslim alınma olgusu. Kapsam: returns:read. |
| `return.closed` | İade/değişim kapandı | Kayıt closed, refunded veya exchanged durumuna geçti. Para ödemesi ayrı refund.succeeded olayıdır. Kapsam: returns:read. |
| `invoice.issued` | Fatura kesildi | e-Arşiv/e-Fatura kaydı issued oldu. Kapsam: invoices:read. |
| `invoice.failed` | Fatura kesilemedi | Kesin hata veya sağlayıcı reddiyle failed oldu; belirsiz bekleyiş hata sayılmaz, sağlayıcı metni gönderilmez. Kapsam: invoices:read. |
| `invoice.cancelled` | Fatura iptal edildi | Fatura cancelled oldu; iptal isteğinin açılması tek başına yeterli değildir. Kapsam: invoices:read. |
| `shipment.created` | Gönderi açıldı | Siparişe kargo gönderisi açıldı. Kapsam: shipments:read. |
| `shipment.status_changed` | Gönderi durumu değişti | Kargo firmasından yeni durum geldi veya gönderi iptal edildi. Kapsam: shipments:read. |
| `shipment.cod_changed` | Kapıda ödeme değişti | Kapıda ödeme tutarı veya tahsilat durumu değişti. Kapsam: shipments:read. |
| `inventory.level_changed` | Stok miktarı değişti | Bir seçeneğin bir depodaki miktarı değişti. Kapsam: inventory:read. |
| `inventory.low` | Stok azaldı | Güncel stok, eşik ve marka bağı birlikte değerlendirilir. Yayın öncesi düşük stoklar başlangıç sayılır; yeni seçenek × depoda ilk düşük stok, sonraki düşüş veya etkin eşik değişip stok düşük kaldığında bildirilir. Kapsam: inventory:read. |
| `inventory.document_created` | Stok belgesi yazıldı | Stok girişi, sayım, fire veya taşıma belgesi oluştu. Kapsam: inventory:read. |
| `inventory.document_reversed` | Stok belgesi geri alındı | Stok belgesi ters kayıtla düzeltildi. Kapsam: inventory:read. |
| `product.created` | Ürün oluşturuldu | Yeni ürün açıldı. Kapsam: products:read. |
| `product.updated` | Ürün değişti | Ürünün bilgileri, fiyatı, satış durumu veya seçenekleri değişti. Kapsam: products:read. |
| `product.archived` | Ürün arşivlendi | Ürün listeden ve vitrinden kalktı. Kapsam: products:read. |
| `product.restored` | Ürün geri getirildi | Arşivdeki ürün geri geldi. Kapsam: products:read. |
| `variant.created` | Seçenek oluşturuldu | Ürüne yeni seçenek eklendi. Kapsam: products:read. |
| `variant.updated` | Seçenek değişti | Seçeneğin fiyatı veya bilgileri değişti. Kapsam: products:read. |
| `variant.archived` | Seçenek arşivlendi | Seçenek üründen kaldırıldı. Kapsam: products:read. |
| `variant.restored` | Seçenek geri getirildi | Arşivdeki seçenek ürünle birlikte geri geldi. Kapsam: products:read. |
| `store_product.linked` | Ürün markaya eklendi | Ürün bir satış markasında satışa açıldı. Kapsam: products:read. |
| `store_product.unlinked` | Ürün markadan çıkarıldı | Ürün bir satış markasından kaldırıldı. Kapsam: products:read. |
| `store_price.updated` | Marka fiyatı değişti | Ürünün veya seçeneğin bir markadaki fiyatı değişti ya da kaldırıldı. Kapsam: products:read. |
| `customer.created` | Müşteri oluşturuldu | Yeni müşteri kartı açıldı. Kapsam: customers:read. |
| `customer.updated` | Müşteri değişti | Müşteri kartının bilgileri değişti. Kapsam: customers:read. |
| `customer.archived` | Müşteri arşivlendi | Müşteri kartı etkin listeden kalktı. Kapsam: customers:read. |
| `customer.restored` | Müşteri geri getirildi | Arşivdeki müşteri kartı geri geldi. Kapsam: customers:read. |
| `customer.anonymized` | Müşteri anonimleştirildi | KVKK isteğiyle kişisel bilgiler temizlendi. Kapsam: customers:read. |
| `subscription.created` | Abonelik başladı | Düzenli teslimatlı sipariş onaylanınca abonelik açıldı; ilk sipariş ve ürün satırlarıyla. Kapsam: subscriptions:read. |
| `subscription.renewed` | Abonelik siparişi açıldı | Vadesi gelen teslimatın yenileme siparişi açıldı; sipariş kimliği ve teslimat günüyle. Kapsam: subscriptions:read. |
| `subscription.payment_issue` | Abonelikte ödeme sorunu | Abonelik ödeme sorunu durumuna geçti; yeni teslimat açılmaz. Kart reddi ayrıca payment.failed olayıdır. Kapsam: subscriptions:read. |
| `subscription.paused` | Abonelik durdu | Abonelik durdu (ürün satıştan kalktı, işletme kapandı veya iptal geri alınıp durmuş haline döndü). Kapsam: subscriptions:read. |
| `subscription.resumed` | Abonelik sürdü | Durmuş, ödeme sorunlu veya iptal edilmiş abonelik yeniden etkin oldu. Kapsam: subscriptions:read. |
| `subscription.cancelled` | Abonelik iptal edildi | Müşteri, satıcı veya ilk siparişin iptali aboneliği kapattı; açılmış siparişler değişmez. Kapsam: subscriptions:read. |
| `coupon.created` | Kupon oluşturuldu | Yeni kupon açıldı. Kapsam: coupons:read. |
| `coupon.updated` | Kupon değişti | Kuponun kodu, indirimi, geçerliliği, sınırları, kapsamı veya açık/kapalı durumu değişti. Kapsam: coupons:read. |
| `coupon.archived` | Kupon arşivlendi | Kupon silindi: listeden kalktı, sepette uygulanmaz; siparişlerdeki kupon kalır. Kapsam: coupons:read. |
| `coupon.restored` | Kupon geri getirildi | Arşivdeki kupon geri geldi. Kapsam: coupons:read. |
| `channel.order_imported` | Kanal siparişi alındı | Bağlı satış kanalındaki (pazaryeri veya site) yeni sipariş içe alındı; sipariş başına bir kez. Kapsam: channels:read. |
| `channel.problem` | Kanal bağlantısında sorun | Kanal bağlantısı çalışmıyor (anahtar veya yetki geçersiz, uygulama kaldırıldı): stok gitmez, sipariş gelmez. Sorun sürerken tekrarlanmaz. Kapsam: channels:read. |
| `channel.recovered` | Kanal bağlantısı düzeldi | Sorunlu kanal bağlantısı yeniden çalışıyor. Kapsam: channels:read. |
| `webhook.test` | Deneme bildirimi | Uç kurulurken veya deneme istendiğinde imzalı gönderilir; abonelikte seçilmesi gerekmez ve olay akışında bulunmaz. Kapsam: webhooks:manage. |

## Örnek yükler

Aşağıdaki katalog backend’in olay kapsamı tablosundan üretilir. Her türün örneği uydurmadır; güncel kaydı okumak için `data.object` kimliğini kullanın.

Kart denemesinin kesin reddi `payment.failed` (`payments:read`), seçenek ve deponun düşük stok eşiği altına geçişi
`inventory.low` (`inventory:read`) ile bildirilir. Aynı kart denemesi ve düşük kalmaya devam eden stok tekrarlanmaz;
yayıncı güncel commit edilmiş stok, eşik ve marka bağını birlikte değerlendirir. Yayın öncesindeki stoklar göçte
başlangıç sayılır; mevcut düşük stoklar toplu bildirim üretmez. Yeni seçenek × depoda ilk düşük stok uyarısı gönderilir.
Sonraki kontrollerde stok yükselip azalınca veya etkin eşik değişince yeni uyarı gelir; marka değişimi tek başına tekrarlatmaz.
Eşik `quantity < threshold` anlamındadır; `previous/current` son kayıtlı durumu ve güncel değerlendirmeyi gösterir (başlangıç veya önceki değerlendirme yoksa `previous` değerleri `null`).

Abonelik olayları (`subscriptions:read`) aboneliğin yeni durumunun adını taşır: `subscription.created`, `renewed`,
`payment_issue`, `paused`, `resumed`, `cancelled`; önceki durum `previous.status` alanındadır. `subscription.renewed`
yenileme siparişinin `order` kimliği ve teslimat günüyle (`period`) gelir. Nesne müşteri kartının `cus_` kimliğini ve ürün
satırlarını (`items`) taşır; ad, iletişim, adres ve not gönderilmez. Kupon olayları (`coupons:read`) kodu, indirimi, alt
sınırı, geçerliliği ve tanımlı müşteri sayısını (`customer_count`) verir; müşteri listesi gönderilmez, Sil kuponu arşivler.
Kanal olaylarında `channels:read` gerekir: `channel.order_imported` bağlı kanaldaki yeni siparişi sipariş başına bir kez
bildirir; `channel.problem` bağlantı çalışmayınca (`authorization`: anahtar veya yetki geçersiz, `app_removed`: Wix
uygulaması kaldırıldı), `channel.recovered` düzelince gelir. Sorun sürerken tekrarlanmaz; kanalın hata metni gönderilmez.

### channel.order_imported

Gerekli kapsamlar: `events:read`, `channels:read`.
Bağlı kanaldaki yeni sipariş içe alındı; sipariş başına bir kez. Var olan siparişe eklenen paket yeni olay değildir. Tam sipariş /orders/{id} ile okunur.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {},
      "previous": {}
    },
    "object": {
      "channel": "trendyol",
      "id": "chn_00000000000000000000000000000001",
      "number": 48273910,
      "order": "ord_00000000000000000000000000000004"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "channel.order_imported"
}
```


### channel.problem

Gerekli kapsamlar: `events:read`, `channels:read`.
Kanal bağlantısının sorunu başlayınca ve düzelince bir kez; sorun sürerken tekrarlanmaz. problem güvenli koddur (authorization, app_removed); kanalın hata metni gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "problem": "authorization"
      },
      "previous": {
        "problem": null
      }
    },
    "object": {
      "channel": "trendyol",
      "id": "chn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "channel.problem"
}
```


### channel.recovered

Gerekli kapsamlar: `events:read`, `channels:read`.
Kanal bağlantısının sorunu başlayınca ve düzelince bir kez; sorun sürerken tekrarlanmaz. problem güvenli koddur (authorization, app_removed); kanalın hata metni gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "problem": null
      },
      "previous": {
        "problem": "authorization"
      }
    },
    "object": {
      "channel": "trendyol",
      "id": "chn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "channel.recovered"
}
```


### collection.recorded

Gerekli kapsamlar: `events:read`, `payments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "status": "succeeded"
      },
      "previous": {
        "amount": "100.00",
        "status": "pending"
      }
    },
    "object": {
      "id": "col_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "collection.recorded"
}
```


### collection.reversed

Gerekli kapsamlar: `events:read`, `payments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00"
      },
      "previous": {
        "amount": "100.00"
      }
    },
    "object": {
      "id": "col_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "collection.reversed"
}
```


### coupon.archived

Gerekli kapsamlar: `events:read`, `coupons:read`.
Kupon: code güncel koddur; Sil kuponu arşivler (coupon.archived). Müşteriye özel kuponun müşteri listesi gönderilmez, customer_count yalnız sayıdır.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "archived": true,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      },
      "previous": {
        "archived": false,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      }
    },
    "object": {
      "code": "MERHABA10",
      "id": "cpn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "coupon.archived"
}
```


### coupon.created

Gerekli kapsamlar: `events:read`, `coupons:read`.
Kupon: code güncel koddur; Sil kuponu arşivler (coupon.archived). Müşteriye özel kuponun müşteri listesi gönderilmez, customer_count yalnız sayıdır.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "archived": false,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      },
      "previous": {
        "archived": null,
        "customer_count": null,
        "discount_type": null,
        "discount_value": null,
        "min_order": null,
        "status": null,
        "valid_from": null,
        "valid_until": null
      }
    },
    "object": {
      "code": "MERHABA10",
      "id": "cpn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "coupon.created"
}
```


### coupon.restored

Gerekli kapsamlar: `events:read`, `coupons:read`.
Kupon: code güncel koddur; Sil kuponu arşivler (coupon.archived). Müşteriye özel kuponun müşteri listesi gönderilmez, customer_count yalnız sayıdır.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "archived": false,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      },
      "previous": {
        "archived": true,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      }
    },
    "object": {
      "code": "MERHABA10",
      "id": "cpn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "coupon.restored"
}
```


### coupon.updated

Gerekli kapsamlar: `events:read`, `coupons:read`.
Kupon: code güncel koddur; Sil kuponu arşivler (coupon.archived). Müşteriye özel kuponun müşteri listesi gönderilmez, customer_count yalnız sayıdır.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "archived": false,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "15.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      },
      "previous": {
        "archived": false,
        "customer_count": 0,
        "discount_type": "percentage",
        "discount_value": "10.00",
        "min_order": "100.00",
        "status": "active",
        "valid_from": "2026-10-16",
        "valid_until": "2026-12-31T23:59"
      }
    },
    "object": {
      "code": "MERHABA10",
      "id": "cpn_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "coupon.updated"
}
```


### customer.anonymized

Gerekli kapsamlar: `events:read`, `customers:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "anonymized": true,
        "archived": false
      },
      "previous": {
        "anonymized": false,
        "archived": false
      }
    },
    "object": {
      "id": "cus_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "customer.anonymized"
}
```


### customer.archived

Gerekli kapsamlar: `events:read`, `customers:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "anonymized": false,
        "archived": true
      },
      "previous": {
        "anonymized": false,
        "archived": false
      }
    },
    "object": {
      "id": "cus_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "customer.archived"
}
```


### customer.created

Gerekli kapsamlar: `events:read`, `customers:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "anonymized": false,
        "archived": false
      },
      "previous": {
        "anonymized": false,
        "archived": false
      }
    },
    "object": {
      "id": "cus_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "customer.created"
}
```


### customer.restored

Gerekli kapsamlar: `events:read`, `customers:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "anonymized": false,
        "archived": false
      },
      "previous": {
        "anonymized": false,
        "archived": true
      }
    },
    "object": {
      "id": "cus_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "customer.restored"
}
```


### customer.updated

Gerekli kapsamlar: `events:read`, `customers:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "anonymized": false,
        "archived": false
      },
      "previous": {
        "anonymized": false,
        "archived": false
      }
    },
    "object": {
      "id": "cus_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "customer.updated"
}
```


### inventory.document_created

Gerekli kapsamlar: `events:read`, `inventory:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {},
      "previous": {}
    },
    "object": {
      "id": "doc_00000000000000000000000000000001",
      "kind": "receipt"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "inventory.document_created"
}
```


### inventory.document_reversed

Gerekli kapsamlar: `events:read`, `inventory:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {},
      "previous": {}
    },
    "object": {
      "id": "doc_00000000000000000000000000000001",
      "kind": "receipt",
      "reverses": "doc_00000000000000000000000000000004"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "inventory.document_reversed"
}
```


### inventory.level_changed

Gerekli kapsamlar: `events:read`, `inventory:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "quantity": "12.000"
      },
      "previous": {
        "quantity": "13.000"
      }
    },
    "object": {
      "id": "lvl_00000000000000000000000000000001",
      "location": "loc_00000000000000000000000000000003",
      "variant": "var_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "inventory.level_changed"
}
```


### inventory.low

Gerekli kapsamlar: `events:read`, `inventory:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "quantity": "2.000",
        "threshold": "3.000"
      },
      "previous": {
        "quantity": "3.000",
        "threshold": "3.000"
      }
    },
    "object": {
      "id": "lvl_00000000000000000000000000000001",
      "location": "loc_00000000000000000000000000000003",
      "variant": "var_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "inventory.low"
}
```


### invoice.cancelled

Gerekli kapsamlar: `events:read`, `invoices:read`.
Fatura kaydı: kind belge türü, total KDV dahil TRY tutarıdır. Belirsiz kesim kesin hata sayılmaz. Alıcı, vergi numarası, fatura numarası ve sağlayıcı hata metni gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "status": "cancelled",
        "total": "120.00"
      },
      "previous": {
        "status": "issued",
        "total": "100.00"
      }
    },
    "object": {
      "id": "inv_00000000000000000000000000000001",
      "kind": "e_arsiv",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "invoice.cancelled"
}
```


### invoice.failed

Gerekli kapsamlar: `events:read`, `invoices:read`.
Fatura kaydı: kind belge türü, total KDV dahil TRY tutarıdır. Belirsiz kesim kesin hata sayılmaz. Alıcı, vergi numarası, fatura numarası ve sağlayıcı hata metni gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "status": "failed",
        "total": "120.00"
      },
      "previous": {
        "status": "pending",
        "total": "100.00"
      }
    },
    "object": {
      "id": "inv_00000000000000000000000000000001",
      "kind": "e_arsiv",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "invoice.failed"
}
```


### invoice.issued

Gerekli kapsamlar: `events:read`, `invoices:read`.
Fatura kaydı: kind belge türü, total KDV dahil TRY tutarıdır. Belirsiz kesim kesin hata sayılmaz. Alıcı, vergi numarası, fatura numarası ve sağlayıcı hata metni gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "status": "issued",
        "total": "120.00"
      },
      "previous": {
        "status": "pending",
        "total": "100.00"
      }
    },
    "object": {
      "id": "inv_00000000000000000000000000000001",
      "kind": "e_arsiv",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "invoice.issued"
}
```


### job.completed

Gerekli kapsamlar: `events:read`, `exports:write` veya `products:write` veya `inventory:write`.
Yalnız işi açan bağlantı ve işin kaynak kapsamları; maliyetli toplu işte costs:write da gerekir.


```json
{
  "actor": {
    "type": "worker"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "status": "completed"
      },
      "previous": {
        "status": "running"
      }
    },
    "object": {
      "id": "exp_1234567890abcdef1234567890abcdef"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "job.completed"
}
```


### order.created

Gerekli kapsamlar: `events:read`, `orders:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "status": "confirmed"
      },
      "previous": {
        "amount": "100.00",
        "status": "pending"
      }
    },
    "object": {
      "id": "ord_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "order.created"
}
```


### order.status_changed

Gerekli kapsamlar: `events:read`, `orders:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "status": "confirmed"
      },
      "previous": {
        "status": "pending"
      }
    },
    "object": {
      "id": "ord_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "order.status_changed"
}
```


### order.updated

Gerekli kapsamlar: `events:read`, `orders:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "status": "confirmed"
      },
      "previous": {
        "amount": "100.00",
        "status": "pending"
      }
    },
    "object": {
      "id": "ord_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "order.updated"
}
```


### payment.failed

Gerekli kapsamlar: `events:read`, `payments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "currency": "TRY",
        "method": "card",
        "provider": "iyzico",
        "provider_code": "declined",
        "status": "failed"
      },
      "previous": {}
    },
    "object": {
      "id": "pat_00000000000000000000000000000001",
      "order": "ord_00000000000000000000000000000004"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "payment.failed"
}
```


### product.archived

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": true,
        "status": "active"
      },
      "previous": {
        "amount": "100.00",
        "archived": false,
        "status": "active"
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "product.archived"
}
```


### product.created

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false,
        "status": "active"
      },
      "previous": {
        "amount": "100.00",
        "archived": false,
        "status": "active"
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "product.created"
}
```


### product.restored

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false,
        "status": "active"
      },
      "previous": {
        "amount": "100.00",
        "archived": true,
        "status": "active"
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "product.restored"
}
```


### product.updated

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false,
        "status": "active"
      },
      "previous": {
        "amount": "100.00",
        "archived": false,
        "status": "active"
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "product.updated"
}
```


### refund.succeeded

Gerekli kapsamlar: `events:read`, `payments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00"
      },
      "previous": {
        "amount": "100.00"
      }
    },
    "object": {
      "id": "rfd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "refund.succeeded"
}
```


### return.approved

Gerekli kapsamlar: `events:read`, `returns:read`.
İade/değişim kaydı: kind türü, status mevcut API durumunu, item_count ürün satırı sayısını, refund_amount tutar olgusunu belirtir. return.closed para ödendiği anlamına gelmez; para iadesi refund.succeeded ile bildirilir.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "item_count": 2,
        "refund_amount": "120.00",
        "status": "approved"
      },
      "previous": {
        "item_count": 2,
        "refund_amount": "100.00",
        "status": "requested"
      }
    },
    "object": {
      "id": "ret_00000000000000000000000000000001",
      "kind": "return",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "return.approved"
}
```


### return.closed

Gerekli kapsamlar: `events:read`, `returns:read`.
İade/değişim kaydı: kind türü, status mevcut API durumunu, item_count ürün satırı sayısını, refund_amount tutar olgusunu belirtir. return.closed para ödendiği anlamına gelmez; para iadesi refund.succeeded ile bildirilir.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "item_count": 2,
        "refund_amount": "120.00",
        "status": "closed"
      },
      "previous": {
        "item_count": 2,
        "refund_amount": "100.00",
        "status": "approved"
      }
    },
    "object": {
      "id": "ret_00000000000000000000000000000001",
      "kind": "return",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "return.closed"
}
```


### return.received

Gerekli kapsamlar: `events:read`, `returns:read`.
İade/değişim kaydı: kind türü, status mevcut API durumunu, item_count ürün satırı sayısını, refund_amount tutar olgusunu belirtir. return.closed para ödendiği anlamına gelmez; para iadesi refund.succeeded ile bildirilir.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "item_count": 2,
        "refund_amount": "120.00",
        "status": "arrived"
      },
      "previous": {
        "item_count": 2,
        "refund_amount": "100.00",
        "status": "approved"
      }
    },
    "object": {
      "id": "ret_00000000000000000000000000000001",
      "kind": "return",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "return.received"
}
```


### return.rejected

Gerekli kapsamlar: `events:read`, `returns:read`.
İade/değişim kaydı: kind türü, status mevcut API durumunu, item_count ürün satırı sayısını, refund_amount tutar olgusunu belirtir. return.closed para ödendiği anlamına gelmez; para iadesi refund.succeeded ile bildirilir.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "item_count": 2,
        "refund_amount": "120.00",
        "status": "declined"
      },
      "previous": {
        "item_count": 2,
        "refund_amount": "100.00",
        "status": "requested"
      }
    },
    "object": {
      "id": "ret_00000000000000000000000000000001",
      "kind": "return",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "return.rejected"
}
```


### return.requested

Gerekli kapsamlar: `events:read`, `returns:read`.
İade/değişim kaydı: kind türü, status mevcut API durumunu, item_count ürün satırı sayısını, refund_amount tutar olgusunu belirtir. return.closed para ödendiği anlamına gelmez; para iadesi refund.succeeded ile bildirilir.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "item_count": 2,
        "refund_amount": "120.00",
        "status": "requested"
      },
      "previous": {
        "item_count": null,
        "refund_amount": "100.00",
        "status": null
      }
    },
    "object": {
      "id": "ret_00000000000000000000000000000001",
      "kind": "return",
      "order": "ord_00000000000000000000000000000002"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "return.requested"
}
```


### shipment.cod_changed

Gerekli kapsamlar: `events:read`, `shipments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "cod_amount": "120.00",
        "cod_collected": "120.00",
        "cod_release": null,
        "cod_state": "collected",
        "cod_status": "COLLECTED"
      },
      "previous": {
        "cod_amount": null,
        "cod_collected": null,
        "cod_release": null,
        "cod_state": "pending",
        "cod_status": "TO_BE_COLLECTED"
      }
    },
    "object": {
      "id": "shp_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "shipment.cod_changed"
}
```


### shipment.created

Gerekli kapsamlar: `events:read`, `shipments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "cod_amount": "120.00",
        "cod_collected": "120.00",
        "cod_release": null,
        "cod_state": "collected",
        "cod_status": "COLLECTED",
        "state": "delivered",
        "status": "DELIVERED"
      },
      "previous": {
        "cod_amount": null,
        "cod_collected": null,
        "cod_release": null,
        "cod_state": "pending",
        "cod_status": "TO_BE_COLLECTED",
        "state": "ready",
        "status": "CREATED"
      }
    },
    "object": {
      "id": "shp_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "shipment.created"
}
```


### shipment.status_changed

Gerekli kapsamlar: `events:read`, `shipments:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "state": "delivered",
        "status": "DELIVERED"
      },
      "previous": {
        "state": "ready",
        "status": "CREATED"
      }
    },
    "object": {
      "id": "shp_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "shipment.status_changed"
}
```


### store_price.updated

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "compare_price": null,
        "price": "120.00"
      },
      "previous": {
        "compare_price": null,
        "price": "100.00"
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "store_price.updated"
}
```


### store_product.linked

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "linked": true
      },
      "previous": {
        "linked": false
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "store_product.linked"
}
```


### store_product.unlinked

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "linked": false
      },
      "previous": {
        "linked": true
      }
    },
    "object": {
      "id": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "store_product.unlinked"
}
```


### subscription.cancelled

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "cancelled"
      },
      "previous": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ]
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.cancelled"
}
```


### subscription.created

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      },
      "previous": {
        "interval_weeks": null,
        "next_date": null,
        "status": null
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ],
      "order": "ord_00000000000000000000000000000004"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.created"
}
```


### subscription.paused

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "paused"
      },
      "previous": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ]
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.paused"
}
```


### subscription.payment_issue

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "payment_issue"
      },
      "previous": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ]
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.payment_issue"
}
```


### subscription.renewed

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.
order yenileme siparişi, period o siparişin teslimat günüdür.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-11-06",
        "period": "2026-10-23",
        "status": "active"
      },
      "previous": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ],
      "order": "ord_00000000000000000000000000000004"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.renewed"
}
```


### subscription.resumed

Gerekli kapsamlar: `events:read`, `subscriptions:read`.
Abonelik: olay yeni durumun adıdır, önceki durum previous.status alanındadır. customer müşteri kartının kimliğidir, items ürün ve seçenek kimlikleridir; ad, iletişim, adres ve not gönderilmez.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "active"
      },
      "previous": {
        "interval_weeks": 2,
        "next_date": "2026-10-23",
        "status": "paused"
      }
    },
    "object": {
      "customer": "cus_00000000000000000000000000000003",
      "id": "sub_00000000000000000000000000000001",
      "items": [
        {
          "product": "prd_00000000000000000000000000000005",
          "variant": "var_00000000000000000000000000000006"
        }
      ]
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "subscription.resumed"
}
```


### variant.archived

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": true
      },
      "previous": {
        "amount": "100.00",
        "archived": false
      }
    },
    "object": {
      "id": "var_00000000000000000000000000000002",
      "product": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "variant.archived"
}
```


### variant.created

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false
      },
      "previous": {
        "amount": "100.00",
        "archived": false
      }
    },
    "object": {
      "id": "var_00000000000000000000000000000002",
      "product": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "variant.created"
}
```


### variant.restored

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false
      },
      "previous": {
        "amount": "100.00",
        "archived": true
      }
    },
    "object": {
      "id": "var_00000000000000000000000000000002",
      "product": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "variant.restored"
}
```


### variant.updated

Gerekli kapsamlar: `events:read`, `products:read`.


```json
{
  "actor": {
    "type": "user"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {
        "amount": "120.00",
        "archived": false
      },
      "previous": {
        "amount": "100.00",
        "archived": false
      }
    },
    "object": {
      "id": "var_00000000000000000000000000000002",
      "product": "prd_00000000000000000000000000000001"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "variant.updated"
}
```


### webhook.test

Yalnız ilgili adrese gönderilen imzalı deneme; abonelikte seçilmesi gerekmez ve olay akışına girmez. Yönetim kapsamı: `webhooks:manage`.


```json
{
  "actor": {
    "type": "system"
  },
  "created_at": "2026-10-16T09:00:00Z",
  "data": {
    "changes": {
      "current": {},
      "previous": {}
    },
    "object": {
      "id": "whe_1234567890abcdef1234567890abcdef"
    }
  },
  "id": "evt_1234567890abcdef1234567890abcdef",
  "livemode": true,
  "schema_version": 1,
  "store": "sto_1234567890abcdef1234567890abcdef",
  "type": "webhook.test"
}
```