Webhooklar: hodisalar va imzoni tekshirish
Buyurtma holati oʻzgarganda serveringizga imzolangan xabar olish va uni tekshirish.
Buyurtma holati oʻzgarganda serveringizga imzolangan POST soʻrov yuboramiz. Bu mijozga natijani tez berish va doimiy soʻrov (polling) yubormaslikning eng yaxshi yoʻli.
Sozlash
- Panelda Webhook boʻlimini oching.
- Webhook URL maydoniga manzilingizni yozing, masalan
https://shop.example.com/partner/webhook. Faqathttps, 443 yoki 8443 port va ochiq (public) manzil qabul qilinadi. - Saqlang. Imzo siri (
whsec_…) faqat bir marta koʻrsatiladi — nusxa olib, server sozlamalarida saqlang. - Webhookni oʻchirish uchun URL maydonini boʻsh qoldirib saqlang.
Sir yoʻqolsa, Yangi sir yaratish tugmasini bosing — eski sir darhol ishlamay qoladi.
Hodisalar
| Hodisa | Qachon |
|---|---|
order.pending |
Buyurtma qabul qilindi |
order.processing |
Yetkazish boshlandi |
order.completed |
Buyurtma bajarildi; kodlar data.delivered ichida |
order.failed |
Buyurtma bajarilmadi va pul qaytarildi |
Soʻrov koʻrinishi
POST /partner/webhook HTTP/1.1
Content-Type: application/json
User-Agent: GOXOST-Partner-Webhooks/1.0
X-Partner-Event: order.completed
X-Partner-Delivery: whd_481
X-Partner-Signature: t=1763200934,v1=5f2c…
{ "id": "whd_481", "event": "order.completed", "created_at": "2026-11-15T10:02:14Z", "data": { …buyurtma… } }
data — API qaytaradigan buyurtma obyektining aynan oʻzi.
Javob va qayta urinishlar
- 5 soniya ichida istalgan
2xxkod bilan javob bering. Ogʻir ishni javobdan keyin bajaring. - Yoʻnaltirishlar (redirect) kuzatilmaydi — yakuniy URL ni yozing.
- Aks holda 1 daqiqa, 5 daqiqa, 30 daqiqa, 2 soat, 6 soat va 24 soatdan keyin qayta yuboramiz.
- Bir xil xabar bir necha marta kelishi mumkin — takrorlarni
idboʻyicha oʻtkazib yuboring. - Hodisalar tartibsiz kelishi mumkin — kelish tartibiga emas,
data.statusvadata.updated_atga ishoning.
Panelning Webhook sahifasida Soʻnggi yuborilganlar roʻyxati bor: hodisa, urinishlar soni va holat (Kutilmoqda, Yetkazildi, Yetkazilmadi).
Imzoni tekshirish
Har bir xabarga ishonishdan oldin uni tekshiring. X-Partner-Signature sarlavhasida t (vaqt) va v1 bor. v1 — "{t}.{xom tana}" qatorining imzo siri bilan HMAC-SHA256 qiymati (hex).
- JSON parse qilinishidan oldingi xom tanadan foydalaning.
- Doimiy vaqtli taqqoslashdan foydalaning.
- 5 daqiqadan eski vaqt belgisini rad eting.
<?php
$body = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_PARTNER_SIGNATURE'] ?? '';
parse_str(str_replace(',', '&', $header), $sig);
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $body, getenv('PARTNER_WEBHOOK_SECRET'));
if (abs(time() - (int) ($sig['t'] ?? 0)) > 300 || ! hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(400);
exit;
}
$event = json_decode($body, true);
http_response_code(200);
import hashlib, hmac, time
def verify(raw_body: bytes, header: str, secret: str) -> bool:
sig = dict(part.split("=", 1) for part in header.split(","))
if abs(time.time() - int(sig.get("t", 0))) > 300:
return False
expected = hmac.new(secret.encode(), f"{sig['t']}.".encode() + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, sig.get("v1", ""))
Imzoni qayta kodlangan JSON boʻyicha tekshirmang — bitta boʻshliq ham xeshni buzadi. Node.js namunasi API hujjatining «Webhooklar» bobida.