hikie üzerine geliştirin
Mağazanızı kendi sistemlerinize bağlayın. Sipariş ödendiğinde, abonelik yenilendiğinde ya da ürün güncellendiğinde hikie sizin belirlediğiniz adrese imzalı bir HTTP isteği gönderir — API’yi sürekli yoklamanıza gerek kalmaz.
Dokümante edilen alanlar
Webhooks
Yayındaİmzalı, yeniden denemeli olay bildirimleri. Mağazanızda bir şey olduğu anda sunucunuz haberdar olur.
- 13
- event tipi
- 72 sa
- retry penceresi
- 10
- teslimat denemesi
- 5 sn
- yanıt süresi
Sunucunuza düşen istek
Her istek HMAC-SHA256 ile imzalanır; gerçekten hikie’den geldiğini doğrulayabilirsiniz.
POST /hikie/webhook HTTP/1.1
Content-Type: application/json
Hikie-Event: order.paid
Hikie-Webhook-Id: wh_1f0c8ab29e7d453b6c1a0e94f27d3b85
Hikie-Timestamp: 1785945600
Hikie-Signature: 4c1f9d0a7e2b8c6f1d3a5e90b47c2f8ae6...
Hikie-Delivery-Attempt: 1
{
"id": "wh_1f0c8ab29e7d453b6c1a0e94f27d3b85",
"event": "order.paid",
"occurredAt": "2026-08-07T09:20:00.000Z",
"data": {
"orderNumber": "HKS-10428",
"totalAmount": 249.9,
"customer": { "email": "[email protected]" }
}
}Dinleyebileceğiniz eventler
Tüm kataloğu gör →order.*
- order.created
- order.paid
- order.payment_failed
refund.*
- refund.requested
- refund.updated
product.*
- product.created
- product.updated
- product.deleted
Nereden başlamalı
Hızlı başlangıç
Aboneliği oluştur, endpoint’i yaz, imzayı doğrula — 10 dakikada ilk teslimat.
İmza doğrulama
Node.js, TypeScript, PHP, Python, Go, C# ve Java için HMAC-SHA256.
Örnek uygulamalar
Express, Fastify ve NestJS için kopyalanıp çalıştırılabilir tam sunucular.
Teslimat ve retry
Sunucunuz kapalıysa ne olur: 72 saate yayılan 10 deneme.
Güvenlik
İmza modeli, secret yönetimi ve hangi hedef adreslerin reddedildiği.
Sık sorulanlar
Sabit IP var mı, secret’ı kaybettim, imza tutmuyor…
