VietQR cho doanh nghiệp: nhận thanh toán bằng mã VietQR

VietQR là gì?

VietQR là chuẩn mã QR chuyển khoản thống nhất của Việt Nam, do NAPAS chủ trì cùng các ngân hàng. Một mã VietQR chứa ngân hàng nhận, số tài khoản, có thể kèm số tiền và nội dung; khách quét bằng app của bất kỳ ngân hàng tham gia nào để chuyển khoản ngay.

NAPAS (Công ty Cổ phần Thanh toán Quốc gia Việt Nam) xây dựng VietQR để mã QR chuyển khoản có cùng một định dạng giữa các ngân hàng, thay vì mỗi ngân hàng một kiểu. Mã VietQR theo bố cục QR quốc tế EMVCo, chứa ngân hàng nhận, số tài khoản và có thể kèm số tiền, nội dung chuyển khoản. App của các ngân hàng tham gia đều đọc được, nhiều ví điện tử có chức năng chuyển tiền đến tài khoản ngân hàng cũng đọc được.

Khi khách xác nhận, tiền đi như một giao dịch chuyển khoản liên ngân hàng thông thường qua hệ thống NAPAS. Khách không cần cài thêm gì, không phải nhập số thẻ, cũng không cần nạp tiền vào ví. Đó là lý do VietQR đã trở thành cách trả tiền quen thuộc nhất cho đơn hàng trực tuyến tại Việt Nam, bên cạnh thanh toán khi nhận hàng.

Khách trả một đơn hàng bằng VietQR như thế nào

1. 01

   Trang thanh toán hiện mã

   Hệ thống của bạn hiển thị ảnh VietQR của đơn này, kèm số tiền và mã đơn bằng chữ để khách đối chiếu.

2. 02

   Khách mở app ngân hàng

   Khách chọn “Quét QR” trong app của ngân hàng mình đang dùng. Trên điện thoại, khách có thể lưu ảnh mã rồi mở lại từ thư viện ảnh trong app ngân hàng.

3. 03

   Thông tin tự điền

   Tài khoản nhận, số tiền và nội dung lấy từ mã, khách chỉ cần kiểm tra lại và xác nhận bằng mã PIN, OTP hoặc sinh trắc học như mọi lần.

4. 04

   Hệ thống của bạn nhận kết quả

   Nhà cung cấp đối chiếu khoản tiền về với đơn hàng và báo cho hệ thống của bạn để xử lý đơn.

Mã QR tĩnh của tài khoản và mã QR động theo từng đơn

Nhiều cửa hàng nhỏ chỉ in mã VietQR của tài khoản ngân hàng và nhờ khách tự nhập số tiền, ghi chú. Đó là mã tĩnh: biết ai nhận tiền nhưng không biết tiền trả cho đơn nào. Mỗi khoản tiền về phải có người ngồi đọc sao kê để khớp, còn khách thì hay nhập sai số tiền hoặc quên ghi nội dung.

Doanh nghiệp bán hàng trực tuyến cần ngược lại: một mã động tạo riêng cho từng đơn, mang đúng số tiền và một mã tham chiếu duy nhất để nhà cung cấp tự động khớp. Đây là khác biệt lớn nhất giữa “có nhận VietQR” ở một sạp hàng và VietQR dùng được cho trang thương mại điện tử hay một nền tảng có hàng nghìn đơn mỗi ngày.

Tích hợp API VietQR cần làm được gì

• Tạo giao dịch cho một đơn hàng và trả về dữ liệu để hiển thị mã, với số tiền và mã tham chiếu gắn chặt vào mã đó.
• Cho mã hết hạn nếu khách không trả, để một khoản chuyển muộn không âm thầm gắn vào đơn bạn đã hủy.
• Có quy trình cho các trường hợp khó: khách trả sai số tiền, trả hai lần hoặc trả sau khi mã hết hạn. Thống nhất với nhà cung cấp cách báo và cách hoàn tiền cho từng trường hợp.
• Báo trạng thái cuối cùng qua thông báo giữa hai máy chủ, không dựa vào việc trình duyệt của khách quay lại trang của bạn.
• Có file đối soát hằng ngày để khớp từng dòng với đơn hàng của bạn.

Thu hộ VietQR qua CVPay

Mỗi bước dưới đây bắt đầu bằng một thông tin sản phẩm cố định của CVPay, sau đó là việc đội của bạn nên làm ở bước đó.

1. 01

   Mở tài khoản

   Merchant được duyệt hồ sơ KYB trước khi sử dụng. Môi trường sandbox được mở trước và tách biệt với môi trường production.

   Đăng ký từ trang này, chuẩn bị hồ sơ công ty và mô tả rõ khách hàng Việt Nam sẽ trả tiền cho sản phẩm hay dịch vụ gì. Dùng sandbox để chạy thử trọn vòng đời đơn hàng, kể cả mã hết hạn mà chưa được trả.

2. 02

   Tích hợp một lần

   Một tài khoản merchant và một API dùng chung cho cả ba loại tiền.

   Thiết kế luồng đơn hàng sao cho phương thức thanh toán chỉ là một tham số. Sau này thêm ví điện tử hay USDT chỉ là đổi cấu hình, không phải làm một dự án thứ hai.

3. 03

   Nối thông báo

   Mỗi lần trạng thái giao dịch thay đổi, hệ thống gửi webhook callback, và mọi callback đều có chữ ký.

   Kiểm tra chữ ký của mọi callback, lưu nguyên nội dung gốc, và viết hàm xử lý sao cho chạy hai lần với cùng một giao dịch vẫn không ghi nhận trùng.

4. 04

   Xác nhận phương thức

   Phương thức thu hộ gồm VietQR, MoMo, ZaloPay và Viettel Money tại Việt Nam; GCash, Maya, GrabPay và QR Ph tại Philippines.

   Trước khi mở bán, xác nhận những phương thức nào đã được bật trên tài khoản merchant của bạn và chỉ hiển thị cho khách những phương thức đó.

VietQR đi cùng MoMo và ZaloPay

VietQR phục vụ người quen trả bằng app ngân hàng. Một nhóm khách không nhỏ, nhất là người trẻ dùng điện thoại nhiều, lại thích xác nhận trong ví điện tử như MoMo hay ZaloPay. Vì vậy nhiều trang thanh toán ở Việt Nam đặt VietQR lên đầu và thêm một hai ví bên cạnh. Khi cả ba đến từ cùng một nhà cung cấp, chúng dùng chung một mô hình đơn hàng và một định dạng thông báo, việc đối soát nằm ở một chỗ.