PhoStackSaaS Kit
Đăng nhậpĐăng ký

VietQR

QR chuyển khoản ngân hàng theo chuẩn NAPAS — khách quét là chuyển đúng số tài khoản, số tiền và nội dung đối soát.

Cấu hình trong 3 bước

Chưa có thông tin tài khoản nhận trong .env — làm theo các bước dưới đây.

  1. 1

    Lấy mã ngân hàng

    Mã BIN (VD 970436) hoặc code (VD vietcombank) — danh sách đầy đủ tại api.vietqr.io/v2/banks.

  2. 2

    Điền 3 biến vào .env

    VIETQR_BANK_ID="970436" · VIETQR_ACCOUNT_NO="0123456789" · VIETQR_ACCOUNT_NAME="CONG TY ABC" (tên tuỳ chọn).

  3. 3

    Khởi động lại dev server

    Env được validate lúc boot (fail fast) — tải lại trang là QR hiện.

Vì sao không có IPN?

Chuyển khoản ngân hàng không có callback xác nhận tiền vào — VietQR là tiện ích hiển thị để khách chuyển đúng thông tin. Đối soát tự động cần dịch vụ báo có (Casso, SePay…) — ngoài phạm vi starter, xem ghi chú trong src/lib/vietqr.ts.