Lưu ý quan trọng
Trước khi tích hợp, vui lòng đọc kỹ các lưu ý dưới đây để đảm bảo hệ thống hoạt động chính xác và ổn định.
Khả năng hỗ trợ QR của các Ngân hàng/Ví điện tử
Tình trạng hỗ trợ QR động/tĩnh phụ thuộc vào từng ngân hàng/ví điện tử và loại tài khoản liên kết (Cá nhân, HKD, hoặc Doanh nghiệp).
- Xem chi tiết tại: Danh sách ngân hàng/VĐT hỗ trợ đầy đủ
| Ngân hàng/Ví điện tử | Cá nhân | Hộ kinh doanh | Doanh nghiệp | |||
|---|---|---|---|---|---|---|
| QR động | QR tĩnh | QR động | QR tĩnh | QR động | QR tĩnh | |
| Vietcombank | ✕ | ✓ | ✓ | ✓ | ✓ | ✓ |
| BIDV | ✕ | ✓ | ✕ | ✓ | ✓ | ✓ |
| VietinBank | ✕ | ✓ | ✕ | ✓ | ✓ | ✓ |
| ||||||
| MBBank | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| VPBank | ✕ | ✓ | ✓ | ✓ | ✓ | ✓ |
| Sacombank | ✕ | ✓ | ✕ | ✓ | ✕ | ✕ |
| ACB | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| OCB | ✓ | ✓ | ✕ | ✓ | ✓ | ✓ |
| VIB | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| PGB | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| TPBank | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| MSB | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| Co-opBank | ✕ | ✓ | ✕ | ✓ | ✕ | ✓ |
| Ví BAOKIM | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
Cấu hình tài khoản trước khi liên kết HKD / Doanh nghiệp
Đối với tài khoản Hộ kinh doanh (HKD) và Doanh nghiệp, một số ngân hàng yêu cầu cấu hình thông tin tài khoản trước khi thực hiện liên kết.
Tự cấu hình qua API
Đối tác có thể chủ động gọi API Cấu hình tài khoản doanh nghiệp để thiết lập:
| Ngân hàng | Loại tài khoản cần cấu hình |
|---|---|
| BIDV | Doanh nghiệp |
| VietinBank | Doanh nghiệp |
| ACB | Doanh nghiệp, Hộ kinh doanh |
| Vietcombank (VCB) | Doanh nghiệp, Hộ kinh doanh |
| VPBank (VPB) | Doanh nghiệp, Hộ kinh doanh |
| MSB | Tất cả loại tài khoản |
Cần liên hệ TINGEE để cấu hình
Một số ngân hàng không hỗ trợ cấu hình qua API — đối tác vui lòng liên hệ đội ngũ TINGEE để được hỗ trợ:
| Ngân hàng | Loại tài khoản cần cấu hình |
|---|---|
| VIB | Doanh nghiệp |
| MBBank | Doanh nghiệp |
| OCB | Doanh nghiệp |
Điều kiện liên kết tài khoản ngân hàng VIB
Đối với ngân hàng VIB (bankBin: "970441"), quy định này áp dụng cho cả 3 loại tài khoản (personal-account, business-household-account, business-account).
Khách hàng bắt buộc phải hoàn tất thủ tục Đăng ký nhận loa trên VIB iBusiness trước khi gọi API Tạo tài khoản ảo (VA).
Các bước thực hiện:
- Bước 1 — Đăng ký tài khoản MyVIB: Nếu Khách hàng chưa từng sử dụng MyVIB, cần tải ứng dụng MyVIB và tiến hành đăng ký mở tài khoản.
- Bước 2 — Đăng ký gói iBusiness: Khách hàng truy cập vào ứng dụng MyVIB và tiến hành đăng ký gói iBusiness.
- Bước 3 — Đăng ký nhận loa trên VIB iBusiness:
- Sử dụng thông tin tài khoản đăng nhập của MyVIB để đăng nhập vào ứng dụng/hệ thống VIB iBusiness.
- Tại giao diện VIB iBusiness, chọn tính năng Đăng ký nhận loa.
Video hướng dẫn thao tác:
- 1. Đăng ký gói iBusiness (MyVIB)
- 2. Đăng ký nhận loa trên VIB iBusiness
Sau khi hoàn tất bước "Đăng ký nhận loa trên VIB iBusiness", đối tác mới có thể gọi API POST /v1/create-va để tạo tài khoản ảo và liên kết tài khoản VIB thành công. Nếu chưa hoàn tất, yêu cầu tạo VA sẽ bị ngân hàng từ chối.
Hỗ trợ liên kết Số tài khoản gốc
Khi gọi API Tạo tài khoản ảo (VA), đối tác sử dụng tham số isNotifyAccountNumber:
false(mặc định): Tạo tài khoản ảo (Virtual Account - VA).true: Liên kết số tài khoản ngân hàng gốc để nhận biến động số dư.
Chỉ các ngân hàng và loại tài khoản trong bảng dưới đây hỗ trợ liên kết số tài khoản gốc:
| Ngân hàng | Loại tài khoản hỗ trợ STK gốc (isNotifyAccountNumber = true) | Hỗ trợ VA (false)? | Ghi chú |
|---|---|---|---|
| ACB | Tất cả loại tài khoản (Cá nhân, HKD, Doanh nghiệp) | ✓ | |
| TPBank | Tất cả loại tài khoản (Cá nhân, HKD, Doanh nghiệp) | ✓ | Cá nhân, HKD không có VA (chỉ Doanh nghiệp mới có VA) |
| VPBank | Cá nhân, Doanh nghiệp | ✓ | Chưa hỗ trợ STK gốc cho HKD |
| OCB | Doanh nghiệp, Hộ kinh doanh | ✓ | Chưa hỗ trợ STK gốc cho Cá nhân |
| VietinBank | Cá nhân, Hộ kinh doanh | ✓ | Chưa hỗ trợ STK gốc cho Doanh nghiệp |
| PGBank | Các loại tài khoản được hỗ trợ | ✕ | Chỉ liên kết STK gốc, không hỗ trợ tạo VA (hệ thống tự động xử lý) |
| Co-opBank | Các loại tài khoản được hỗ trợ | ✕ | Chỉ liên kết STK gốc, không hỗ trợ tạo VA (hệ thống tự động xử lý) |
Đối với các ngân hàng còn lại, hệ thống mặc định hỗ trợ tạo tài khoản ảo (VA), đối tác truyền isNotifyAccountNumber = false hoặc để mặc định.
- Tài khoản hỗ trợ liên kết STK gốc (
isNotifyAccountNumber = true): Khi người chuyển tiền chuyển vào Số tài khoản gốc, ngân hàng mới ghi nhận biến động và gửi dữ liệu về Tingee → Tingee phát sinh Webhook gửi sang đối tác. - Tài khoản KHÔNG hỗ trợ liên kết STK gốc (chỉ hỗ trợ VA,
isNotifyAccountNumber = false):- Bắt buộc người chuyển tiền phải chuyển vào Số tài khoản ảo (VA) được cấp thì Tingee mới nhận được thông báo biến động và gửi Webhook.
- Nếu chuyển tiền vào Số tài khoản gốc, phía ngân hàng sẽ không ghi nhận giao dịch thuộc phạm vi tích hợp của Tingee → Tingee không nhận được giao dịch từ ngân hàng → Không có Webhook gửi sang đối tác.
Giao dịch QR động — Rủi ro chỉnh sửa số tiền
Đối với các giao dịch thanh toán qua QR động, người thực hiện giao dịch có thể tự ý thay đổi số tiền tại thời điểm quét mã, khiến số tiền thực nhận khác với số tiền được nhúng trong mã QR.
Xem hướng dẫn xác thực giao dịch chi tiết tại Webhook thanh toán — Lưu ý giao dịch QR động.