Event kataloğu
Dinleyebileceğiniz tüm event tipleri, ne zaman tetiklendikleri ve ortak gövde yapısı.
Abonelik oluştururken bu listeden dilediklerinizi seçersiniz. Yalnızca seçtikleriniz gönderilir.
Tüm eventler
| Event | Ne zaman | Ayrıntı |
|---|---|---|
order.paid | Ödeme başarıyla tamamlandı | Sipariş |
order.updated | Siparişin kendi durumu COMPLETED, REFUNDED veya CANCELLED oldu | Sipariş |
order.shipmentUpdated | Siparişin kargo durumu değişti | Sipariş |
subscription.payment_failed | Abonelik yenileme çekimi başarısız oldu (her denemede bir kez) | Abonelik |
subscription.cancelled | Abonelik kapandı, bir daha yenilenmeyecek | Abonelik |
product.created | Yeni ürün eklendi | Ürün |
product.updated | Ürün güncellendi | Ürün |
product.deleted | Ürün silindi | Ürün |
license.created | Bir üye için lisans anahtarı üretildi | Lisans |
license.revoked | Satıcı bir anahtarı iptal etti | Lisans |
license.restored | İptal edilmiş anahtar geri alındı | Lisans |
test.ping | Panelden "Test gönder" | Test |
license.* eventleri yalnızca Yazılım modülü kurulu mağazalarda üretilir.
Bunlar lisansın geçerliliğini değil, kaydın değiştiğini bildirir —
ayrıntı ve iade davranışı için Lisans eventleri.
Kaldırıldı: order.created, order.payment_failed, refund.requested,
refund.updated ve product.out_of_stock artık yok ve seçilemez.
İstek gövdesi
Zarf yok. Gövde doğrudan event payload'ıdır; event tipi, teslimat kimliği, API sürümü ve hesap kimliği HTTP başlıklarında taşınır.
{
"orderId": "17716204135268844HKS",
"status": "COMPLETED",
"storeSlug": "magazam",
"totals": { "total": "249.90" }
}Event tipini gövdeden değil başlıktan okuyun:
const eventType = req.get('Hikie-Event'); // "order.paid"
const webhookId = req.get('Hikie-Webhook-Id');
const occurredAt = req.get('Hikie-Occurred-At');
const payload = JSON.parse(rawBody); // modelin kendisi| Başlık | Ne taşır |
|---|---|
Hikie-Event | Event tipi — yukarıdaki tablodan biri |
Hikie-Webhook-Id | Teslimat kimliği; yeniden denemelerde değişmez. Tekrar kontrolünüzün anahtarı |
Hikie-Account-Id | Mağaza hesabınızın kimliği. Tek endpoint birden fazla mağazaya hizmet ediyorsa ayırt etmek için |
Hikie-Occurred-At | İşin gerçekten olduğu an (ISO 8601 UTC) — sıralama için bunu kullanın |
Hikie-Api-Version | Payload şemasının sürümü (2026-09-04) |
Hikie-Delivery-Attempt | Kaçıncı deneme olduğu |
Tam liste: İstek başlıkları.
Gövde tüm yeniden denemelerde bayt bayt aynı kalır. Deneme sayısı ve zaman damgası gövdede değil başlıklarda olduğu için gövdeyi hash'leyip karşılaştırabilirsiniz.
Ortak kurallar
Her model aynı kuralları izler:
| Kural | Ayrıntı |
|---|---|
| Tutarlar | Dize, iki ondalıklı: "249.90". Asla JSON sayısı değil |
| Para birimi | Modelin kökünde currency alanı. Bugün TRY |
| Tarihler | date önekli adlar (dateCreated, dateUpdated), ISO 8601 UTC |
| Kimlikler | Modelin adını taşır: orderId, productId, subscriptionId. Asla çıplak id |
| Gruplama | İlişkili alanlar iç içe nesnelerde: totals, customerInfo, items, pricing, plan |
| Enum'lar | Mağazanın kendi değerleri (COMPLETED, DIGITAL, out_of_stock) — event sayfalarına bakın |
Alan kuralları
Sürüm politikası
Payload şemasının sürümü Hikie-Api-Version başlığında taşınır. Şu anki
sürüm: 2026-09-04.
- Kırıcı olmayan değişiklikler (yeni alan, yeni event tipi) sürümü artırmaz.
- Kırıcı değişiklikler (alan kaldırma, tip değiştirme) yeni bir sürümle gelir; eski sürüm bir süre desteklenir.
Sürümü kontrol etmek isterseniz:
const surum = req.get('Hikie-Api-Version');
if (surum !== '2026-09-04') {
console.warn(`[hikie] beklenmeyen API sürümü: ${surum}`);
}