İçeriğe geç
siparis.app geliştiriciAnahtarları yönet ↗

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.

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):

{
  "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 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.

KodTürkçe adıNe zaman
job.completedİş bittiDışa aktarma veya toplu fiyat/stok işi tamamlandı ya da başarısız oldu. Kapsam: exports:write, products:write, inventory:write.
order.createdSipariş oluşturulduVitrin, panel, AI, API veya pazaryerinden yeni sipariş geldi. Kapsam: orders:read.
order.updatedSipariş değiştiSiparişin tutarı, kalemleri, adresi, notları veya alt kayıtları değişti. Kapsam: orders:read.
order.status_changedSipariş durumu değiştiSipariş 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.succeededPara iade edildiMüşteriye para iadesi tamamlandı. Kapsam: payments:read.
payment.failedKart ödemesi başarısızPayTR 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 reddedildiTalep 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.issuedFatura kesildie-Arşiv/e-Fatura kaydı issued oldu. Kapsam: invoices:read.
invoice.failedFatura kesilemediKesin hata veya sağlayıcı reddiyle failed oldu; belirsiz bekleyiş hata sayılmaz, sağlayıcı metni gönderilmez. Kapsam: invoices:read.
invoice.cancelledFatura iptal edildiFatura cancelled oldu; iptal isteğinin açılması tek başına yeterli değildir. Kapsam: invoices:read.
shipment.createdGönderi açıldıSiparişe kargo gönderisi açıldı. Kapsam: shipments:read.
shipment.status_changedGönderi durumu değiştiKargo firmasından yeni durum geldi veya gönderi iptal edildi. Kapsam: shipments:read.
shipment.cod_changedKapıda ödeme değiştiKapıda ödeme tutarı veya tahsilat durumu değişti. Kapsam: shipments:read.
inventory.level_changedStok miktarı değiştiBir seçeneğin bir depodaki miktarı değişti. Kapsam: inventory:read.
inventory.lowStok 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_createdStok belgesi yazıldıStok girişi, sayım, fire veya taşıma belgesi oluştu. Kapsam: inventory:read.
inventory.document_reversedStok belgesi geri alındıStok belgesi ters kayıtla düzeltildi. Kapsam: inventory:read.
product.createdÜrün oluşturulduYeni ü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 getirildiArşivdeki ürün geri geldi. Kapsam: products:read.
variant.createdSeçenek oluşturulduÜrüne yeni seçenek eklendi. Kapsam: products:read.
variant.updatedSeçenek değiştiSeçeneğin fiyatı veya bilgileri değişti. Kapsam: products:read.
variant.archivedSeçenek arşivlendiSeçenek üründen kaldırıldı. Kapsam: products:read.
variant.restoredSeçenek geri getirildiArş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.updatedMarka 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.createdMüşteri oluşturulduYeni müşteri kartı açıldı. Kapsam: customers:read.
customer.updatedMüşteri değiştiMüşteri kartının bilgileri değişti. Kapsam: customers:read.
customer.archivedMüşteri arşivlendiMüşteri kartı etkin listeden kalktı. Kapsam: customers:read.
customer.restoredMüşteri geri getirildiArşivdeki müşteri kartı geri geldi. Kapsam: customers:read.
customer.anonymizedMüşteri anonimleştirildiKVKK isteğiyle kişisel bilgiler temizlendi. Kapsam: customers:read.
subscription.createdAbonelik başladıDüzenli teslimatlı sipariş onaylanınca abonelik açıldı; ilk sipariş ve ürün satırlarıyla. Kapsam: subscriptions:read.
subscription.renewedAbonelik 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_issueAbonelikte ödeme sorunuAbonelik ödeme sorunu durumuna geçti; yeni teslimat açılmaz. Kart reddi ayrıca payment.failed olayıdır. Kapsam: subscriptions:read.
subscription.pausedAbonelik durduAbonelik durdu (ürün satıştan kalktı, işletme kapandı veya iptal geri alınıp durmuş haline döndü). Kapsam: subscriptions:read.
subscription.resumedAbonelik sürdüDurmuş, ödeme sorunlu veya iptal edilmiş abonelik yeniden etkin oldu. Kapsam: subscriptions:read.
subscription.cancelledAbonelik iptal edildiMüşteri, satıcı veya ilk siparişin iptali aboneliği kapattı; açılmış siparişler değişmez. Kapsam: subscriptions:read.
coupon.createdKupon oluşturulduYeni kupon açıldı. Kapsam: coupons:read.
coupon.updatedKupon değiştiKuponun kodu, indirimi, geçerliliği, sınırları, kapsamı veya açık/kapalı durumu değişti. Kapsam: coupons:read.
coupon.archivedKupon arşivlendiKupon silindi: listeden kalktı, sepette uygulanmaz; siparişlerdeki kupon kalır. Kapsam: coupons:read.
coupon.restoredKupon geri getirildiArşivdeki kupon geri geldi. Kapsam: coupons:read.
channel.order_importedKanal 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.problemKanal bağlantısında sorunKanal 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.recoveredKanal bağlantısı düzeldiSorunlu kanal bağlantısı yeniden çalışıyor. Kapsam: channels:read.
webhook.testDeneme bildirimiUç 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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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.

{
  "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"
}