Webhooks

1. ໃນໜ້າ Integrations ສ່ວນ Webhooks ກົດ ເພີ່ມ Webhook (Project ຕ້ອງມີຮ້ານ Business Apps ໃນເວັບ ຫຼື ເປີດ Business Apps API ຫຼື Wi-Fi Hotspot API ແລະ ທ່ານເປັນ Owner ຫຼື Admin)
2. ໃສ່ URL ແບບ https:// ທີ່ເຂົ້າເຖິງໄດ້ຈາກອິນເຕີເນັດ ແລະ ເລືອກເຫດການທີ່ຕ້ອງການ (ບໍ່ເລືອກ = ທຸກເຫດການ)
3. ສຳເນົາ Signing secret ເກັບໄວ້ ລະບົບສະແດງຄັ້ງດຽວ
4. ກົດ ທົດສອບ ເພື່ອສົ່ງເຫດການ ping ໄປລອງທີ່ URL ຂອງທ່ານ

ແຕ່ລະເຫດການສົ່ງເປັນ POST ແບບ JSON ລະບົບຂອງທ່ານຕ້ອງຕອບ 2xx ພາຍໃນ 10 ວິນາທີ ຖ້າບໍ່ຕອບ ລະບົບສົ່ງຊ້ຳອັດຕະໂນມັດ (ຫ່າງຂຶ້ນເລື້ອຍໆ ຈົນເຖິງປະມານໜຶ່ງວັນ) ເບິ່ງປະຫວັດການສົ່ງໄດ້ທີ່ປຸ່ມ ປະຫວັດການສົ່ງ

{"id":"evt_…","type":"order.created","createdAt":"2026-10-13T09:30:00Z","shopId":"…","data":{…}}

ກວດວ່າ Webhook ມາຈາກພວກເຮົາແທ້

ທຸກຄັ້ງມີ header X-TH-Signature: t=<ເວລາ>,v1=<ລາຍເຊັນ> ລາຍເຊັນຄື HMAC-SHA256 ຂອງ <ເວລາ>.<body> ດ້ວຍ Signing secret ຂອງທ່ານ ໃຫ້ຄຳນວນຈາກ body ດິບທີ່ໄດ້ຮັບ ກ່ອນແປງເປັນ JSON

const crypto = require("crypto");
function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(",").map(p => p.split("=")));
  const mac = crypto.createHmac("sha256", secret).update(parts.t + "." + rawBody).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(parts.v1));
}

import hmac, hashlib
def verify(raw_body: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    mac = hmac.new(secret.encode(), parts["t"].encode() + b"." + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, parts["v1"])

ເຫດການອາດມາຮອດບໍ່ຕົງລຳດັບ ໃຫ້ລຽງຕາມ createdAt ແລະ ໃຊ້ id ກັນການປະມວນຜົນຊ້ຳ ເພາະເຫດການເດີມອາດຖືກສົ່ງຊ້ຳໄດ້