Đối với site WooCommerce, không cần tự code webhook receiver — plugin BeePay chính thức xử lý hết. Bài này hướng dẫn cài đặt + cấu hình từ A-Z trong 15 phút.

Bước 1: Cài plugin

  1. Mua plugin tại /tai-nguyen/beepay-wordpress-plugin — file .zip
  2. Vào WP Admin → Plugins → Add New → Upload Plugin
  3. Chọn file .zip → Install Now → Activate

Bước 2: Cấu hình kết nối BeePay

Vào WP Admin → BeePay → Settings. Điền:

  • API Key — lấy ở id.beepay.vn/account
  • Payment Prefix — đặt 2-10 ký tự A-Z0-9, vd SHOP
  • Bank Code / Account / Holder — TK nhận tiền

Bấm "Đăng ký webhook" — plugin tự gọi BeePay API tạo system + register webhook URL {site}/api/beepay-webhook → BeePay trả secret_key, plugin lưu vào DB. Không cần làm gì thêm bên dashboard BeePay.

Bước 3: Bật cổng thanh toán

Vào WooCommerce → Settings → Payments → kích hoạt "BeePay - Chuyển khoản tự động". Tuỳ biến:

  • Tên hiển thị checkout: vd "Chuyển khoản 24/7 (auto-confirm)"
  • Mô tả: vd "Quét VietQR bằng app ngân hàng. Đơn xác nhận tự động trong vài giây."
  • Hiển thị logo: tick để show logo các bank tại checkout

Bước 4: Test

Tạo đơn test 10.000đ → checkout chọn BeePay → modal QR hiện ra với:

  • Logo bank + tên + số TK + chủ TK
  • QR động (VietQR sinh từ order_id duy nhất)
  • Nội dung CK (có nút Copy)
  • Status "Đang chờ thanh toán..." (pulse animation)

Quét QR bằng app bank, chuyển 10.000đ. Trong 5-15 giây, modal flip thành "✓ Thanh toán thành công" → redirect sang thank-you page → email gửi cho khách + admin.

Tự động hoá thêm

Plugin có hooks cho:

  • Gửi Telegram báo đơn realtime ngay khi paid
  • SMS xác nhận qua HethongSMS
  • Auto-complete đơn ảo (digital products) bằng hook woocommerce_thankyou
  • Trigger Zalo ZNS gửi mã kích hoạt khoá học

Troubleshooting

  • Webhook không tới: check log dashboard BeePay (id.beepay.vn/webhook-logs). Thường do site chưa public-reachable hoặc firewall block
  • Order không match: nội dung CK của khách thiếu order_id. Check log payment_prefix có đúng không
  • HMAC fail: secret bị copy nhầm (có space đầu/cuối) — re-register

Plugin cập nhật miễn phí 12 tháng. Hỗ trợ qua Zalo/Email khi cần — chi tiết tại /tai-nguyen/beepay-wordpress-plugin.