Quickstart — 5 phút

Hướng dẫn nhận webhook đầu tiên từ BeePay.

🤖 Dùng AI để tự động tích hợp

Nếu bạn dùng Claude / ChatGPT / Cursor, tải prompt markdown → điền 4 thông tin → paste vào AI → AI sinh toàn bộ code. Bỏ qua bước code thủ công.

1. Đăng ký tài khoản

Vào id.beepay.vn/register — tạo tài khoản miễn phí (100 giao dịch/tháng, không cần thẻ).

2. Kết nối nguồn nhận giao dịch

Chọn 1 trong 3 cách:

Android app

Settings → Install BeePay Android APK
→ Cấp quyền đọc SMS + Notification
→ Quét QR trên trang Thiết bị để pair

IMAP email

Settings → Mail accounts → Add
→ Gmail App Password HOẶC IMAP server (ACB, VCB web-email)
→ Test kết nối

iOS webhook

Settings → Thiết bị → iOS → Copy URL cá nhân
→ iOS Shortcut tự động gọi URL khi có notification

3. Tạo webhook endpoint

Thêm endpoint trong Dashboard → Webhook:

POST https://yourshop.com/beepay-webhook

BeePay sẽ gửi POST với headers:

Content-Type: application/json
X-Webhook-Signature: sha256=<HMAC body với secret_key>
X-Webhook-Source: beepay

Body:

{
  "event": "bank_transaction",
  "bank_code": "MB",
  "bank_name": "MB Bank",
  "transaction_type": "credit",
  "amount": "500000.00",
  "currency": "VND",
  "account_number": "008000888",
  "transaction_ref": "FT26111330819043",
  "transaction_date": "2026-04-21T09:30:15.000Z",
  "description": "BEEPAY42 thanh toan",
  "counterpart_name": "NGUYEN VAN A",
  "order_id": "BEEPAY42",
  "transaction_id": 12345,
  "timestamp": 1745227515
}

4. Test

Dashboard → Webhook → Test → BeePay sẽ gửi payload mẫu đến endpoint bạn vừa thêm. Nếu server bạn trả 200 OK → webhook đã sẵn sàng.

5. Xác minh trên production

Chuyển khoản thật 2.000đ với nội dung chứa order_id của bạn. Mở Dashboard → Giao dịch — bạn sẽ thấy giao dịch trong vài giây, webhook_status = success.

---

Bước tiếp theo

• Webhook hoạt động như thế nào — hiểu flow end-to-end
• Xác thực chữ ký webhook — bảo mật production
• Tích hợp WooCommerce — plugin miễn phí