Sozlash
- Panelda Webhook bo'limini oching va URL manzilingizni kiriting, masalan
https://shop.example.com/partner/webhook. Faqat 443 yoki 8443 portdagihttpsmanzillar qabul qilinadi. - Saqlang. Webhook maxfiy kaliti (
whsec_…) faqat bir marta ko'rsatiladi — uni server sozlamalaringizga nusxalang, masalanPARTNER_WEBHOOK_SECRETsifatida. - Maxfiy kalitni istalgan vaqtda shu joyda almashtirishingiz mumkin.
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
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-Webhook-Mode: live
X-Partner-Signature: t=1763200934,v1=5f2c…
{ "id": "whd_481", "event": "order.completed", "created_at": "2026-11-15T10:02:14Z", "data": { …order… } }
data — API qaytaradigan buyurtma obyektining o'zi — qarang: Buyurtmalar.
X-Webhook-Mode — haqiqiy buyurtmalar uchun live, sandbox buyurtmalari uchun test (data ichida "sandbox": true ham bor). Ishlab turgan tizimda test yetkazishlarini e'tiborsiz qoldiring.
Javob va qayta yuborish
- 5 soniya ichida istalgan
2xxholat bilan javob bering. Og'ir ishlarni javob bergandan keyin bajaring. - Yo'naltirishlarga (redirect) amal qilinmaydi — yakuniy URL ni kiriting.
- Aks holda biz 1 daqiqa, 5 daqiqa, 30 daqiqa, 2 soat, 6 soat va 24 soatdan keyin qayta yuboramiz.
- Bitta yetkazma bir necha marta kelishi mumkin: takrorlarni
idbo'yicha o'tkazib yuboring. - Hodisalar tartibsiz kelishi mumkin: kelish tartibiga emas,
data.statusvadata.updated_atga ishoning.
Imzoni tekshirish
Har bir webhookka ishonishdan oldin uni tekshiring. v1 — bu "{t}.{raw body}" qiymatining webhook maxfiy kalitingiz bilan olingan HMAC-SHA256 si, hex ko'rinishida. So'rovning xom tanasidan (JSON ga ajratishdan oldin) foydalaning, doimiy vaqtda solishtiring va 5 daqiqadan eski vaqt belgilarini 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);
const crypto = require('crypto');
// app.post('/partner/webhook', express.raw({ type: 'application/json' }), handler)
function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(',').map((p) => p.split('=')));
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(`${sig.t}.${rawBody}`).digest('hex');
return sig.v1?.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}
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 hech qachon qayta kodlangan JSON bo'yicha tekshirmang. Hatto bitta bo'sh joy o'zgarsa ham xesh buziladi — doim xom tanadan foydalaning.