vietqr-core-sdk

Hướng Dẫn Cài Đặt Plugins Doanh Nghiệp (WooCommerce, WHMCS, HostBill)

Hệ sinh thái VietQR Core SDK cung cấp sẵn các bộ plugin cổng thanh toán chuẩn doanh nghiệp dành cho các nền tảng thương mại điện tử và tự động hóa hóa đơn hosting phổ biến nhất:

  1. WordPress / WooCommerce: Nền tảng bán hàng thương mại điện tử số 1 thế giới.
  2. WHMCS: Hệ thống quản lý và tự động hóa hóa đơn hosting, tên miền hàng đầu.
  3. HostBill: Nền tảng thanh toán và quản lý hạ tầng Cloud/VPS/Hosting cho doanh nghiệp viễn thông.

1. Plugin WordPress / WooCommerce

Vị trí: plugins/wordpress-woocommerce/

Tính năng

Hướng dẫn cài đặt

  1. Sao chép thư mục plugins/wordpress-woocommerce vào thư mục plugins của WordPress:
    cp -r plugins/wordpress-woocommerce /var/www/html/wp-content/plugins/vietqr-woocommerce
    
  2. Đăng nhập vào trang Quản trị WordPress > Plugins (Gói mở rộng) > Installed Plugins.
  3. Tìm VietQR Payment Gateway for WooCommerce và bấm Kích hoạt (Activate).
  4. Vào WooCommerce > Cài đặt (Settings) > Thanh toán (Payments) > VietQR (NAPAS 247) > Quản lý (Manage).
  5. Điền mã BIN ngân hàng (ví dụ: 970422 cho MBBank), số tài khoản, tên chủ tài khoản và Secret Key.
  6. Bấm Lưu thay đổi.

2. Module Thanh Toán WHMCS

Vị trí: plugins/whmcs/

Tính năng

Hướng dẫn cài đặt

  1. Sao chép các tệp vào thư mục cài đặt WHMCS:
    cp plugins/whmcs/modules/gateways/vietqr.php /path/to/whmcs/modules/gateways/
    cp plugins/whmcs/modules/gateways/callback/vietqr.php /path/to/whmcs/modules/gateways/callback/
    
  2. Truy cập WHMCS Admin Area > System Settings > Payment Gateways.
  3. Tại tab All Payment Gateways, chọn kích hoạt VietQR.
  4. Điền mã BIN, số tài khoản, tên chủ tài khoản và Webhook Secret Key.
  5. Bấm Save Changes.

3. Module Thanh Toán HostBill

Vị trí: plugins/hostbill/

Tính năng

Hướng dẫn cài đặt

  1. Sao chép thư mục module vào HostBill:
    cp -r plugins/hostbill/includes/modules/Payment/vietqr /path/to/hostbill/includes/modules/Payment/
    
  2. Trong trang HostBill Admin, vào Settings > Modules > Payment Modules.
  3. Bấm Activate tại mục VietQR.
  4. Cấu hình thông tin ngân hàng thụ hưởng và Webhook Secret.
  5. Bấm lưu cấu hình.

4. Định Dạng Webhook Đối Soát Tự Động Chung

Cả 3 plugin đều sử dụng chung một định dạng Webhook JSON chuẩn:

Yêu cầu HTTP: