Asosiy qismga o'tish

Hodisalar · 9-bob

Webhooklar

Buyurtma holati o'zgarganda biz serveringizga imzolangan POST so'rov yuboramiz. Webhooklar mijozga natijani berishning eng tez yo'li va doimiy so'rab turishga hojat qoldirmaydi.

2 daqiqa o'qish

Sozlash

  1. Panelda Webhook bo'limini oching va URL manzilingizni kiriting, masalan https://shop.example.com/partner/webhook. Faqat 443 yoki 8443 portdagi https manzillar qabul qilinadi.
  2. Saqlang. Webhook maxfiy kaliti (whsec_…) faqat bir marta ko'rsatiladi — uni server sozlamalaringizga nusxalang, masalan PARTNER_WEBHOOK_SECRET sifatida.
  3. 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 2xx holat 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 id bo'yicha o'tkazib yuboring.
  • Hodisalar tartibsiz kelishi mumkin: kelish tartibiga emas, data.status va data.updated_at ga 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", ""))
Muhim

Imzoni hech qachon qayta kodlangan JSON bo'yicha tekshirmang. Hatto bitta bo'sh joy o'zgarsa ham xesh buziladi — doim xom tanadan foydalaning.