Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Nhận Webhook & Xác thực HMAC ▾
Tài liệu›Cổng Thanh Toán (Checkout)›Nhận Webhook & Xác thực HMAC
Phiên bản:v1.0.5 (Chính thức)

Nhận Webhook & Xác thực HMAC

Hướng dẫn tiếp nhận thông báo PAYMENT_PAID từ BankGateway và kiểm tra chữ ký X-BankGateway-Signature chống giả mạo.

Headers Webhook gửi về Server bạn

HeaderMô tả
X-BankGateway-EventPAYMENT_PAID (thanh toán thật) hoặc PAYMENT_TEST (bấm Test 1-Click).
X-BankGateway-TimestampUnix timestamp (ms) lúc gửi Webhook. Nên từ chối nếu lệch quá 5 phút.
X-BankGateway-SignatureHMAC-SHA256 hex của chuỗi "${timestamp}.${rawBody}" ký bằng Secret Key của bạn.

Code mẫu xác thực Webhook an toàn (Node.js / PHP / Python)

import crypto from "node:crypto";

export function verifyBankGatewayWebhook(req, secretKey) {
  const ts = req.headers["x-bankgateway-timestamp"];
  const sig = req.headers["x-bankgateway-signature"];
  const rawBody = typeof req.body === "string" ? req.body : JSON.stringify(req.body);

  if (!ts || !sig || Math.abs(Date.now() - Number(ts)) > 5 * 60 * 1000) {
    return false; // Chặn Replay Attack quá 5 phút
  }

  const expected = crypto
    .createHmac("sha256", secretKey)
    .update(`${ts}.${rawBody}`)
    .digest("hex");

  return crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected));
}
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗