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

Hướng dẫn tích hợp Cổng thanh toán QR chuyển khoản ngân hàng tự động (payment.bankgateway.pro / .vn) với chữ ký bảo mật HMAC-SHA256.

Luồng hoạt động 3 bước

BankGateway Pay giúp website của bạn tạo trang thanh toán QR chuyển khoản ngân hàng chuyên nghiệp (Hosted Checkout tại payment.bankgateway.pro hoặc payment.bankgateway.vn) và tự động đối soát tiền vào 24/7.

  1. 01
    1. Đăng ký & Nhận Secret Key

    Chủ cửa hàng vào Dashboard > Tự động hóa giao dịch > Cổng thanh toán > Đăng ký để nhận Merchant ID và Secret Key (sk_live_...).

  2. 02
    2. Tạo đơn từ Backend (Ký HMAC-SHA256)

    Khi khách bấm Thanh toán, Backend của bạn gọi POST /api/v1/payment-gateway/checkout kèm signature ký bằng Secret Key, nhận về checkoutUrl và chuyển hướng người mua.

  3. 03
    3. Tự động đối soát & Nhận Webhook

    Người mua quét VietQR chuyển tiền thật vào tài khoản ngân hàng của bạn. Ngay khi tiền vào, BankGateway bắn Webhook PAYMENT_PAID kèm X-BankGateway-Signature để website bạn tự động cộng tiền.

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 ↗