Thanh toán QR Tự động BIDV
bởi Viindoo
| Số dòng Code | 1552 |
| Tên kỹ thuật | payment_bidv_viin |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/payment_bidv_viin |
| Đọc mô tả cho | v 17.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Kết nối ngân hàng BIDV Kết nối ngân hàng Ghi nhật ký API Request |
| Các mở rộng | Điểm bán lẻ - Tự động thanh toán mã QR với BIDV |
Mỗi khoản chuyển tiền BIDV vào đúng hóa đơn - một lần, đúng số tiền thực nhận
Khách hàng quét mã VietQR của BIDV để thanh toán hóa đơn hoặc đơn bán; khi BIDV xác nhận khoản chuyển tiền, thanh toán được ghi nhận tự động lên đúng chứng từ đó, và khoản chuyển tiền lệch số tiền được đánh dấu để kế toán xử lý.
Thanh toán QR Tự động BIDV (tên kỹ thuật payment_bidv_viin) là ứng dụng Odoo 18.0 cho Odoo Community, Odoo Enterprise và Viindoo Cloud, dành cho doanh nghiệp tại Việt Nam thu tiền hóa đơn và đơn bán bằng VND qua tài khoản BIDV.
Tóm tắt nhanh
Dữ kiện về Thanh toán QR Tự động BIDV, phiên bản 0.1.5, gom một chỗ. Phát hành bởi Viindoo.
Cách vận hành
Thiết lập một lần, sau đó mọi khoản thanh toán tự chạy.
Quản trị viên bật BIDV
Trên cổng thanh toán BIDV, chọn sổ nhật ký thanh toán có tài khoản ngân hàng đã kết nối BIDV rồi bật cổng. Nếu còn thiếu gì - Merchant ID, Service ID, mã định danh ngân hàng, tỉnh/thành phố của chủ tài khoản - hệ thống liệt kê ra và chưa cho bật.
Khách hàng quét mã và thanh toán
Trên hóa đơn hoặc đơn hàng, khách chọn BIDV và nhận mã QR kèm số tiền, người thụ hưởng và một số tài khoản thanh toán dành riêng cho khoản thanh toán này. Khách rời khỏi trang thanh toán sẽ thấy lại đúng hướng dẫn thanh toán đó trên hóa đơn.
BIDV xác nhận, chứng từ được thanh toán
BIDV thông báo cho hệ thống, thanh toán được ghi nhận và hóa đơn chuyển sang đã thanh toán. Không ai phải nhập gì.
Kế toán rà các trường hợp ngoại lệ
Một bộ lọc, BIDV: chênh lệch số tiền trong Giao dịch thanh toán, liệt kê các khoản thanh toán BIDV có số tiền khác với số đã yêu cầu; mỗi khoản hiển thị số tiền yêu cầu bên cạnh số tiền thực nhận. Menu Giao dịch thanh toán chỉ hiện trong chế độ nhà phát triển.
Bạn nhận được gì
Mỗi khoản thanh toán có số tài khoản thanh toán BIDV riêng, nhờ đó BIDV báo cho hệ thống chính xác khoản chuyển tiền trả cho hóa đơn hay đơn hàng nào.
Thông báo BIDV gửi lại cho cùng một khoản chuyển tiền không được ghi nhận lần thứ hai; khoản chuyển tiền thứ hai cho một khoản thanh toán đã được ghi nhận bị từ chối và có ghi chú.
Khi khách trả nhiều hơn hoặc ít hơn số yêu cầu, hệ thống ghi nhận số tiền thực nhận, giữ lại số tiền yêu cầu bên cạnh và để lại ghi chú trên chứng từ.
Nếu hóa đơn đã thanh toán hoặc đã hủy khi khách quét mã, BIDV được báo không thu tiền và ghi chú trên chứng từ nêu rõ lý do.
Cổng thanh toán không bật được cho tới khi sổ nhật ký, tài khoản ngân hàng và các mã định danh BIDV thực sự thu được tiền; nếu không tạo được mã QR, khách hàng được đề nghị liên hệ công ty thay vì thấy một mã hỏng.
Ứng dụng này không làm gì
Hãy đọc trước khi mua. Những điều bên dưới là việc ứng dụng chủ ý để lại cho ứng dụng khác hoặc cho bạn.
Phương thức thanh toán chỉ hiển thị cho Việt Nam và VND. Khoản chuyển tiền lệch số tiền trên chứng từ dùng tiền tệ khác không được hạch toán tự động; giao dịch được tách riêng kèm thông báo đề nghị ghi nhận thủ công.
Việc hoàn tiền thực hiện ngoài ứng dụng này.
Merchant ID, Service ID và các khóa được thiết lập trong Kết nối ngân hàng BIDV.
Thanh toán QR tại điểm bán lẻ là ứng dụng riêng, Điểm bán lẻ - Tự động thanh toán mã QR với BIDV.
Kết hợp tốt với
Các ứng dụng cùng hệ, được xây để ghép với ứng dụng này:
Kết nối ngân hàng BIDV
Bắt buộc. Lưu tài khoản BIDV, địa chỉ callback và các khóa.
viin_bidv_connectorBán hàng
Khi có ứng dụng Bán hàng, đơn bán được thanh toán theo cùng cách và nhận cùng loại ghi chú.
sale
Ai nên dùng Thanh toán QR Tự động BIDV?
Kế toán
Không còn dò sao kê BIDV bằng tay; thấy ngay trong ngày các khoản lệch số tiền và các lần bị từ chối.
Nhân viên kinh doanh
Thấy đơn hàng đã được thanh toán, và lý do khi thanh toán của khách bị từ chối, mà không phải hỏi kế toán.
Quản trị viên hệ thống
Chỉ bật BIDV khi thiết lập đã đầy đủ, và có mọi lượt gọi từ BIDV trong nhật ký.
Khách hàng của bạn
Quét mã, kiểm tra số tiền, thanh toán - không phải gõ số tài khoản hay nội dung chuyển khoản.
Câu hỏi thường gặp
Thanh toán QR Tự động BIDV làm gì?
Ứng dụng thêm BIDV làm nhà cung cấp thanh toán trực tuyến: khách hàng quét mã VietQR của BIDV trên trang thanh toán của hóa đơn hoặc đơn bán, và khi BIDV xác nhận khoản chuyển tiền thì thanh toán được ghi nhận lên chứng từ đó, một lần, đúng số tiền thực nhận.
Thanh toán QR Tự động BIDV không làm gì?
Ứng dụng không thu bằng tiền tệ khác VND hay qua ngân hàng khác, không hoàn tiền, và không xử lý tại điểm bán lẻ. Ứng dụng cần Kết nối ngân hàng BIDV và đăng ký BIDV Open API.
Thanh toán QR Tự động BIDV dành cho ai?
Doanh nghiệp tại Việt Nam xuất hóa đơn bằng VND và thu tiền qua tài khoản BIDV - kế toán, nhân viên kinh doanh và khách hàng của họ.
Điều gì xảy ra khi khách chuyển một số tiền khác?
Số tiền thực nhận được ghi nhận, số tiền yêu cầu được giữ trên giao dịch, một ghi chú được để lại trên chứng từ, và bộ lọc "BIDV: chênh lệch số tiền" liệt kê khoản thanh toán đó.
Điều gì xảy ra nếu BIDV gửi cùng một thông báo hai lần?
Lần thứ hai được xác nhận và không ghi nhận gì thêm.
Điều gì xảy ra nếu hóa đơn đã thanh toán hoặc đã hủy khi khách quét mã QR?
BIDV được báo là không có gì để thanh toán nên không thu tiền, và ghi chú trên hóa đơn hoặc đơn hàng cho biết đã có một lần thanh toán và lý do bị từ chối.
Khách hàng thấy gì nếu không tạo được mã QR?
Một thông báo đề nghị liên hệ công ty của bạn, số tiền và người thụ hưởng vẫn được hiển thị.
Thiết lập như thế nào?
Kết nối tài khoản BIDV trong Kết nối ngân hàng BIDV, sau đó mở cổng thanh toán BIDV, chọn sổ nhật ký thanh toán của tài khoản đó và bật cổng.
Hỗ trợ phiên bản và ấn bản Odoo nào?
Odoo 18.0 - Odoo Community, Odoo Enterprise, Viindoo Cloud. Nâng cấp lên dòng Odoo mới hơn là một lần mua riêng cho dòng đó.
Ứng dụng phụ thuộc vào gì?
Ứng dụng cài trên nền: payment, account_payment, viin_bidv_connector. Odoo sẽ cài kèm khi cài ứng dụng này.
Kết hợp tốt với ứng dụng nào?
Kết nối ngân hàng BIDV (viin_bidv_connector): Bắt buộc. Lưu tài khoản BIDV, địa chỉ callback và các khóa. Bán hàng (sale): Khi có ứng dụng Bán hàng, đơn bán được thanh toán theo cùng cách và nhận cùng loại ghi chú. Điểm bán lẻ - Tự động thanh toán mã QR với BIDV (viin_pos_qr_bidv): Cùng tài khoản BIDV đó tại quầy.
Có thể dùng thử trước khi mua không?
Có - nút Live Preview ở đầu trang này mở màn hình của chính ứng dụng trên một cơ sở dữ liệu đang chạy.
Nhận hỗ trợ bằng cách nào?
Gửi thư tới apps.support@viindoo.com kèm phiên bản Odoo và tên kỹ thuật payment_bidv_viin; câu hỏi trước bán hàng gửi sales@viindoo.com.
Xem Thanh toán QR Tự động BIDV vận hành
Live demo: v18demo-vn.viindoo.com
Cần hỗ trợ về Thanh toán QR Tự động BIDV?
Cần giải đáp, hỗ trợ triển khai hay phát triển thêm tính năng, hãy liên hệ Viindoo.
Tư vấn bán hàng & hợp tác
sales@viindoo.comNâng cấp lên dòng Odoo mới hơn là một lần mua riêng cho dòng đó.
Tất cả ứng dụng Viindoo: /apps/modules/browse?author=Viindoo
Yêu cầu kỹ thuật
Nhật ký thay đổi
0.1.5 - Odoo 18.0
- Khách đã rời khỏi trang thanh toán sẽ thấy lại đúng hướng dẫn thanh toán đó trên hóa đơn.
- Đơn bán đã thanh toán đủ từ chối lần thanh toán thứ hai qua một số tài khoản thanh toán cũ.
- Thẻ thanh toán nằm gọn trong khung của nó khi không tạo được mã QR.
0.1.4 - Odoo 18.0
- Thanh toán được ghi nhận đúng số tiền thực nhận, giữ lại số tiền yêu cầu và có bộ lọc cho các khoản chênh lệch.
- Thông báo lặp lại chỉ được ghi nhận một lần.
- Lượt quét trên chứng từ đã thanh toán hoặc đã hủy bị từ chối kèm ghi chú trên chứng từ.
- Cổng thanh toán kiểm tra thiết lập trước khi được bật.
0.1.1 - Odoo 18.0
- Bản phát hành đầu tiên cho Odoo 18.0.
Thanh toán QR Tự động BIDV
Note
Mở rộng từ Kết nối ngân hàng BIDV - xem tài liệu của mô-đun này: viin_bidv_connector.
Tổng quan
Thanh toán QR Tự động BIDV cho phép khách hàng thanh toán hóa đơn - hoặc đơn bán, khi đã cài Bán hàng - bằng cách quét mã VietQR của BIDV trên trang thanh toán trực tuyến. Khi BIDV xác nhận đã nhận tiền, hệ thống ghi nhận khoản thanh toán lên chứng từ đó, đúng một lần, theo số tiền BIDV báo là đã nhận, và hóa đơn được đánh dấu đã thanh toán. Không ai phải đối chiếu sao kê ngân hàng bằng tay.
Hành trình của một khoản thanh toán:
- Khách hàng mở hóa đơn hoặc đơn bán trên cổng thông tin khách hàng, nhấp Thanh toán ngay, chọn BIDV paygate và nhấp Thanh toán. Trang "Hoàn tất thanh toán của bạn" hiện mã QR, số tiền, người thụ hưởng, ngân hàng và một số tài khoản thanh toán riêng cho khoản thanh toán này. Khách rời khỏi trang sẽ thấy lại đúng hướng dẫn đó khi mở hóa đơn sau này, trên bất kỳ thiết bị nào.
- Khách hàng quét mã bằng app ngân hàng (hoặc chuyển khoản đến số tài khoản được hiển thị) và thanh toán.
- BIDV hỏi hệ thống khách còn nợ bao nhiêu, rồi thông báo số tiền đã nhận. Hệ thống tự trả lời, không ai phải nhấp gì.
- Kế toán thấy hóa đơn đã thanh toán, khoản thanh toán đã được ghi nhận và đối trừ, cùng một ghi chú trên chứng từ mỗi khi có điều bất thường.
Ai dùng mô-đun này:
| Vai trò | Công việc | Quyền truy cập cần gán |
|---|---|---|
| Quản trị viên hệ thống | Bật thu tiền qua BIDV: chọn sổ nhật ký thanh toán của cổng BIDV, kích hoạt và cho hiển thị. | Quản trị / Thiết lập |
| Nhân viên kế toán | Theo dõi các khoản đã thu, kiểm tra các lần chuyển có số tiền khác, đọc ghi chú trên hóa đơn. | Kế toán / Hóa đơn |
| Kế toán trưởng | Làm các việc của nhân viên kế toán và vào được các menu Khoản thanh toán online (cổng thanh toán, giao dịch thanh toán trong chế độ nhà phát triển). | Kế toán / Quản trị viên |
| Nhân viên bán hàng | Thấy trên đơn bán rằng khách đã thanh toán và đọc các ghi chú BIDV trong lịch sử của đơn. | Bán hàng / Người dùng: Chỉ tài liệu của chính mình |
| Khách hàng thanh toán | Thanh toán bằng cách quét mã QR. Không cần quyền truy cập nào: khách dùng cổng thông tin. | Không có (người dùng cổng thông tin) |
Các vai trò trong bảng là những người thường đảm nhận từng công việc; công ty bạn có thể phân chia khác đi.
Trước khi bắt đầu
- Kết nối ngân hàng BIDV đã được thiết lập. Tài khoản ngân hàng BIDV của công ty, Mã đầu TK định danh và Mã dịch vụ, các địa chỉ BIDV gọi đến và các khóa đều được giải thích trong tài liệu Kết nối ngân hàng BIDV: viin_bidv_connector. Hãy làm phần đó trước.
- Chỉ VND và Việt Nam. BIDV thu tiền bằng đồng Việt Nam, cho khách hàng tại Việt Nam. Cổng BIDV chỉ áp dụng cho tiền tệ VND và quốc gia Việt Nam, nên chứng từ bằng tiền tệ khác sẽ không được đề nghị BIDV.
Thiết lập (dành cho Quản trị viên hệ thống)
Cài đặt
- Mở Ứng dụng và tìm Thanh toán QR Tự động BIDV.
- Nhấp Cài đặt. Kết nối ngân hàng BIDV và ứng dụng Hóa đơn được cài cùng.
Bật BIDV
- Mở Hóa đơn ‣ Cấu hình ‣ Khoản thanh toán online ‣ Cổng thanh toán và mở BIDV. (Menu Cấu hình hiển thị cho người dùng có quyền Kế toán / Quản trị viên.)
- Ở thẻ Thông tin đăng nhập, một thông báo màu xanh nhắc rằng BIDV thu tiền vào tài khoản ngân hàng của Sổ nhật ký thanh toán.
- Mở thẻ Cấu hình và chọn Sổ nhật ký thanh toán. Chọn sổ nhật ký ngân hàng có tài khoản ngân hàng được kết nối với BIDV, tức là tài khoản có Kết nối ngân hàng là BIDV (xem tài liệu Kết nối ngân hàng BIDV).
- Ở Trạng thái, chọn Đã bật để thu tiền thật, hoặc Chế độ kiểm thử để chạy thử. Nhấp Lưu.
Ba trạng thái có nghĩa như sau:
- Đã tắt: BIDV không được đề nghị cho ai.
- Đã bật: BIDV được đề nghị cho khách hàng của bạn. Chọn Đã bật cũng bật nút Đã hiển thị.
- Chế độ kiểm thử: BIDV dùng để chạy thử. Chọn trạng thái này sẽ tắt Đã hiển thị, nên khách hàng không thấy BIDV; nhân viên đã đăng nhập vào hệ thống thì thấy. Mô-đun này xử lý các cuộc gọi của BIDV như nhau ở cả hai trạng thái.
Đã hiển thị là nút ở đầu biểu mẫu. Cổng đã bật nhưng ở trạng thái Đã hủy hiển thị sẽ không được đề nghị cho khách hàng - họ không thấy BIDV trên trang thanh toán, và nếu BIDV là phương thức duy nhất thì họ được báo là không có phương thức thanh toán nào. Nhấp nút để chuyển giữa Đã hiển thị và Đã hủy hiển thị; cổng đã tắt không thể cho hiển thị.
Cổng BIDV có sẵn một Thông báo treo mặc định ở thẻ Tin nhắn, là nội dung khách đọc trên trang "Hoàn tất thanh toán của bạn": "Hãy quét mã QR bằng app ngân hàng của bạn, hoặc chuyển khoản đến số tài khoản được hiển thị và giữ nguyên số tiền. Thanh toán của bạn sẽ được xác nhận tự động ngay khi BIDV thông báo cho chúng tôi."
Khi hệ thống từ chối bật BIDV
Trước khi bật (hoặc chạy thử) BIDV, hệ thống kiểm tra sổ nhật ký thanh toán có thật sự thu được tiền không. Nếu thiếu gì đó, việc lưu thất bại với thông báo "Cổng thanh toán BIDV BIDV chưa thể được kích hoạt cho đến khi sổ nhật ký thanh toán của cổng này được thiết lập để thu tiền qua BIDV:" và mỗi mục còn thiếu nằm trên một dòng. Hãy sửa hết rồi lưu lại.
Các dòng bạn có thể gặp và cách xử lý:
| Dòng | Cần làm gì |
|---|---|
| sổ nhật ký thanh toán | Cổng chưa có Sổ nhật ký thanh toán. Hãy chọn một sổ ở thẻ Cấu hình. |
| tài khoản ngân hàng trên sổ nhật ký thanh toán ... | Mở sổ nhật ký và gán cho nó một tài khoản ngân hàng. |
| tài khoản ngân hàng ... của sổ nhật ký thanh toán phải sử dụng kết nối ngân hàng BIDV | Mở Danh bạ ‣ Cấu hình ‣ Tài khoản ngân hàng ‣ Tài khoản ngân hàng, mở tài khoản và chọn BIDV ở Kết nối ngân hàng. Các mục sau chỉ được kiểm tra khi mục này đã đúng. |
| Mã đầu TK định danh BIDV trên tài khoản ngân hàng ... | Nhập Mã đầu TK định danh BIDV trên tài khoản ngân hàng. |
| Mã đầu TK định danh BIDV ngắn hơn 19 ký tự để vừa với bí danh thanh toán | Dùng Mã đầu TK định danh đúng như BIDV cấp; mã này phải ngắn hơn 19 ký tự. |
| Mã dịch vụ BIDV trên tài khoản ngân hàng ... | Nhập Mã dịch vụ BIDV trên tài khoản ngân hàng. |
| ngân hàng có Mã định danh ngân hàng (BIC) là mã BIN NAPAS 6 chữ số, không phải mã SWIFT, ... | Mở Danh bạ ‣ Cấu hình ‣ Tài khoản ngân hàng ‣ Ngân hàng, mở BIDV và nhập 970418. |
| thành phố hoặc tỉnh/thành của chủ tài khoản ... | Mở chủ tài khoản (liên hệ của công ty bạn) và điền Thành phố hoặc Tỉnh/TP. |
Việc kiểm tra này cũng chạy khi bạn lưu một cổng đã bật, nên đổi trạng thái từ Đã bật sang Chế độ kiểm thử cũng bị từ chối nếu còn thiếu mục nào.
Khách hàng thanh toán: thanh toán bằng cách quét mã QR
Khách hàng dùng cổng thông tin khách hàng, từ đường dẫn trong email hoặc từ danh sách hóa đơn của cổng thông tin.
- Mở hóa đơn (hoặc đơn bán) và nhấp Thanh toán ngay.
- Chọn BIDV paygate và nhấp Thanh toán.
- Trang "Hoàn tất thanh toán của bạn" mở ra. Trang hiện:
- mã QR, kèm dòng "Quét QR bằng app ngân hàng của bạn";
- Số tiền cần trả, tính bằng đồng;
- Người thụ hưởng và Ngân hàng;
- Số tài khoản, là số tài khoản thanh toán chỉ dành cho khoản thanh toán này: Mã đầu TK định danh của bạn nối với một con số. Mỗi khoản thanh toán có một số riêng.
- Khách hàng quét mã bằng app ngân hàng và xác nhận chuyển khoản, giữ nguyên số tiền. Khách cũng có thể chuyển khoản bằng tay đến số tài khoản được hiển thị.
Sau khi khách đã chọn BIDV, hóa đơn hiện trạng thái Đang chờ trên cổng thông tin và nút Thanh toán ngay bị ẩn cho đến khi khoản thanh toán được tất toán. Thay vào đó, trang hóa đơn hiện lại đúng hướng dẫn "Hoàn tất thanh toán của bạn" như trên: cùng mã QR, số tiền, người thụ hưởng, ngân hàng và số tài khoản thanh toán. Nhờ vậy khách đã đóng trang có thể mở lại hóa đơn - từ cổng thông tin, hoặc từ liên kết thanh toán bạn gửi - trên bất kỳ thiết bị nào, và thanh toán với cùng số tài khoản thanh toán đó. Với đơn bán, trang của đơn hiện hướng dẫn theo cách tương tự.
Khi không tạo được mã QR
Nếu hệ thống không tạo được mã QR - ví dụ mã ngân hàng của BIDV không phải mã 6 chữ số, hoặc chủ tài khoản không có thành phố hay tỉnh/thành - khách hàng thấy "Mã QR không khả dụng - vui lòng liên hệ" kèm tên công ty của bạn, thay cho mã. Số tiền, người thụ hưởng, ngân hàng và số tài khoản vẫn được hiển thị, nên khách vẫn có thể chuyển khoản đến số tài khoản được hiển thị. Cách sửa nằm ở phía bạn: xem bảng "Thông báo và cách xử lý" bên dưới.
Nhân viên kế toán: theo dõi các khoản đã thu
Điều gì xảy ra khi BIDV xác nhận
Khi BIDV thông báo đã nhận tiền, hệ thống:
- xác nhận giao dịch thanh toán và ghi mã giao dịch BIDV vào Tham chiếu của cổng thanh toán;
- tạo khoản thanh toán và đối trừ với hóa đơn (việc này do chính xử lý của Odoo thực hiện ngay sau cuộc gọi của BIDV, chậm nhất là bởi hành động định kỳ "Thanh toán: Xử lý sau giao dịch", chạy mỗi 10 phút);
- đánh dấu hóa đơn Đã thanh toán.
Nhân viên kế toán thấy kết quả ở ba nơi:
- Trên hóa đơn (Hóa đơn ‣ Khách hàng ‣ Hóa đơn): trạng thái Đã thanh toán, các nút Thanh toán và Giao dịch thanh toán, và trong lịch sử bên dưới biểu mẫu các dòng "has been confirmed (BIDV)" và "The payment related to the transaction ... has been posted".
- Trong các khoản thanh toán: Hóa đơn ‣ Khách hàng ‣ Thanh toán, một khoản thanh toán đặt tên theo sổ nhật ký, ví dụ PBNK1/2026/00001.
- Trên đơn bán, với đơn đã thanh toán: trạng thái thành Đơn bán, và lịch sử có các dòng tương tự.
Khi số tiền khác nhau
Khách có thể chuyển ít hơn hoặc nhiều hơn số tiền được yêu cầu. Hệ thống không bao giờ từ chối khoản tiền mà BIDV báo đã nhận:
- Số tiền của giao dịch trở thành số tiền thực nhận, và khoản thanh toán được ghi theo số tiền đó. Chuyển thiếu thì hóa đơn ở trạng thái Đã thanh toán một phần cho phần còn lại; chuyển thừa thì hóa đơn được thanh toán và phần thừa còn lại là số dư có của khách.
- Số tiền đã yêu cầu được giữ ở Số tiền yêu cầu.
- Một ghi chú được đăng trên hóa đơn (hoặc đơn bán): "BIDV payment <mã BIDV>: expected 6,600,000 ₫, received 6,000,000 ₫." (ghi chú được viết bằng ngôn ngữ đặt trên liên hệ của công ty).
Để tìm các lần chuyển này, hãy mở giao dịch thanh toán:
- Từ hóa đơn (dùng được cho Nhân viên kế toán và Kế toán trưởng, ở chế độ thường): mở hóa đơn và nhấp nút Giao dịch thanh toán. Biểu mẫu giao dịch hiện Số tiền và Số tiền yêu cầu nằm liền nhau.
- Từ danh sách (Kế toán trưởng, chế độ nhà phát triển): bật chế độ nhà phát triển, mở Hóa đơn ‣ Cấu hình ‣ Khoản thanh toán online ‣ Giao dịch thanh toán và, trong ô tìm kiếm, mở bộ lọc rồi chọn BIDV: chênh lệch số tiền. Danh sách chỉ còn các giao dịch có số tiền khác với số tiền đã yêu cầu.
Cần biết:
- Menu Cấu hình, và do đó là danh sách trên, hiển thị cho người dùng có quyền Kế toán / Quản trị viên. Nhân viên kế toán không có quyền này sẽ không thấy menu đó, kể cả ở chế độ nhà phát triển; nhân viên kế toán vào cùng giao dịch ấy từ hóa đơn như mô tả ở trên.
- Nếu một hóa đơn có nhiều hơn một giao dịch, nút Giao dịch thanh toán mở danh sách của chúng, và bộ lọc nói trên nằm trong ô tìm kiếm của danh sách đó.
- Người dùng có quyền kế toán chỉ đọc (ví dụ kiểm toán viên) không được mô-đun này cấp quyền vào giao dịch thanh toán. Người dùng đó rà soát tiền BIDV trong Hóa đơn ‣ Khách hàng ‣ Thanh toán.
Khi BIDV được yêu cầu không nhận tiền
Trước khi khách thanh toán, app ngân hàng hỏi BIDV khách còn nợ bao nhiêu, và BIDV hỏi hệ thống. Hệ thống từ chối, và app ngân hàng báo là không còn khoản nào phải trả, khi việc nhận tiền là không đúng. Sau đó hệ thống đăng một ghi chú trên hóa đơn (hoặc đơn bán):
A BIDV payment of DEMO-MERCHANT000009 was attempted on Oct 14, 2026, 8:42:46 AM (Asia/Ho_Chi_Minh) and refused before any money was collected. Reason: This transaction is already paid.
Ghi chú là nơi duy nhất hiển thị lý do. Thời gian tính theo múi giờ của liên hệ công ty bạn, và ghi chú được viết bằng ngôn ngữ đặt trên liên hệ đó, bất kể ai mở. Các ghi chú đã đăng sẽ không được dịch lại sau này. Ví dụ trên bằng tiếng Anh vì liên hệ của công ty dùng tiếng Anh.
Các lý do hệ thống có thể đưa ra, theo thứ tự hệ thống kiểm tra:
| Lý do trong ghi chú | Ý nghĩa |
|---|---|
| This transaction is already paid. | Khách quét mã QR của một khoản thanh toán đã được xác nhận. App ngân hàng báo hóa đơn đã tất toán. |
| The documents it pays are already settled. | Hóa đơn đã được thanh toán trong lúc đó - bằng một lần chuyển khác, hoặc bằng khoản thanh toán ghi nhận thủ công - rồi mã cũ mới được quét. Đơn bán cũng vậy: khi đã thanh toán đủ, lượt quét một số tài khoản thanh toán khác của cùng đơn sẽ bị từ chối theo cách tương tự, và ghi chú được đăng trên đơn. Đơn mới thanh toán một phần (đặt cọc, còn phải trả thêm) vẫn thanh toán được. |
| The documents it pays are cancelled. | Hóa đơn hoặc đơn bán bị hủy sau khi khách chọn BIDV. App ngân hàng báo không có hóa đơn nào để trả. |
| This transaction is cancelled. | Bản thân giao dịch thanh toán đã bị hủy. |
| This transaction is in error. | Giao dịch thanh toán đang ở trạng thái Lỗi. |
| It has no amount to pay in VND. | Chứng từ không có số tiền dương bằng đồng để thu. |
Các lần quét lặp lại vì cùng một lý do chỉ để lại một ghi chú. Nếu giao dịch lại thanh toán được, lần từ chối kế tiếp sẽ được ghi chú lại.
Cùng một thông báo hai lần, và lần chuyển thứ hai
- Cùng một giao dịch BIDV được thông báo lại (BIDV đôi khi lặp lại thông báo): không có gì được ghi nhận lần nữa. Vẫn chỉ có một giao dịch, một khoản thanh toán và không có ghi chú mới.
- Lần chuyển thứ hai, khác mã, cho chứng từ đã thanh toán: hệ thống không ghi nhận. Hệ thống trả lời BIDV là giao dịch đã tất toán và đăng ghi chú "A second BIDV payment <mã BIDV> was refused: the transaction <tham chiếu> is already paid." Hãy hỏi BIDV xem tiền của khách đã được hoàn lại chưa; nếu tiền đã về tài khoản của bạn, hãy hoàn lại hoặc đối trừ bằng tay.
- Lượt quét một số tài khoản thanh toán khác của đơn bán đã thanh toán đủ: BIDV được báo là hóa đơn đã tất toán và ghi chú "The documents it pays are already settled." được đăng trên đơn, như với hóa đơn. Đơn mới thanh toán một phần vẫn thanh toán được.
- Khoản tiền nhận được sau khi giao dịch đã bị hủy: tiền vẫn được ghi nhận, và một ghi chú cho biết "BIDV payment <mã BIDV> was received after the transaction <tham chiếu> had been cancelled. It is recorded as a customer payment: apply it to another document or refund it."
Chứng từ bằng tiền tệ khác
BIDV chỉ thu bằng đồng, và cổng BIDV chỉ áp dụng cho VND. Nếu số tiền BIDV báo khác với số tiền yêu cầu trên một giao dịch không tính bằng đồng, hệ thống không ghi nhận. Hệ thống đặt giao dịch ở trạng thái Lỗi, giữ số tiền đã yêu cầu ở Số tiền yêu cầu và ghi thông báo: "Khoản thanh toán BIDV <mã BIDV> với số tiền <số tiền nhận> không khớp với số tiền yêu cầu <số tiền yêu cầu>. Hệ thống không tự động ghi nhận vì giao dịch không tính bằng VND: hãy ghi nhận thủ công." Hãy đăng ký khoản thanh toán bằng tay. Điều này lấy từ mã nguồn của mô-đun; trên hệ thống chuẩn thì không đến được, vì BIDV không được đề nghị cho chứng từ không tính bằng đồng.
Nhân viên bán hàng: thấy đơn đã thanh toán
Khi khách thanh toán một đơn bán qua BIDV, nhân viên bán hàng thấy trên đơn:
- Mở Bán hàng ‣ Đơn hàng ‣ Đơn hàng và mở đơn.
- Khi đơn yêu cầu thanh toán trực tuyến, trạng thái là Đơn bán: việc xác nhận đến cùng với khoản thanh toán.
- Trong lịch sử bên dưới biểu mẫu, đọc các dòng "A transaction with reference ... has been initiated (BIDV)", "... is pending (BIDV)", "... has been confirmed (BIDV)" và "The payment related to the transaction ... has been posted", rồi đến phần xác nhận đơn.
Khách quay lại trang của đơn sẽ thấy lại hướng dẫn thanh toán ở đó. Đơn mà khách chưa thanh toán vẫn là báo giá. Nếu BIDV được yêu cầu không nhận tiền cho đơn, ghi chú đã mô tả ở trên nằm trong cùng lịch sử đó.
Mã QR in trên hóa đơn
Đừng nhầm hai mã QR khác nhau:
- Mã QR trên trang thanh toán là mã do mô-đun này tạo. Mã mang số tài khoản thanh toán của giao dịch, nhờ đó BIDV nhận ra khoản thanh toán và báo cho hệ thống. Lần chuyển khoản bằng mã này được ghi nhận tự động.
- Mã QR in trên PDF hóa đơn là tính năng "Mã QR" của riêng Odoo cho hóa đơn. Mã mang số tài khoản của tài khoản ngân hàng và tham chiếu hóa đơn, không mang số tài khoản thanh toán. BIDV chỉ gọi hệ thống với số tài khoản thanh toán, và hệ thống không tìm thấy giao dịch nào ứng với tham chiếu hóa đơn: khi thử mã này, hệ thống trả lời BIDV là khách hàng không tồn tại (mã 011) và không ghi nhận gì. Lần chuyển khoản bằng mã này không được ghi nhận tự động; nhân viên kế toán đăng ký khoản thanh toán bằng tay.
Nếu bạn vẫn muốn có mã QR in, hãy thiết lập như sau:
- Mở Hóa đơn ‣ Cấu hình ‣ Thiết lập và tích Mã QR.
- Mở Danh bạ ‣ Cấu hình ‣ Tài khoản ngân hàng ‣ Tài khoản ngân hàng, mở tài khoản BIDV và, ở phần Cấu hình QR EMV, đặt Loại proxy là Số tài khoản ngân hàng và Giá trị proxy là số tài khoản.
- Bảo đảm Ngân hàng người nhận của hóa đơn (thẻ Thông tin khác) là tài khoản đó.
Khi chưa có proxy, hóa đơn không in mã QR nào. Việc in hóa đơn ra PDF thậm chí bị từ chối, kèm thông báo của Odoo rằng không tạo được mã QR vì proxy: "Loại proxy none không được hỗ trợ cho khách hàng Việt Nam. Nó phải là ID người bán, số thẻ ATM hoặc tài khoản ngân hàng" - hoặc "Thiếu loại proxy." / "Thiếu giá trị proxy." tùy mục nào còn trống. Khi đã đặt proxy, PDF in một mã bên dưới hóa đơn.
Nâng cấp từ Odoo 17
Nếu bạn đã làm theo tài liệu của phiên bản 17, đây là những gì thay đổi:
- Các thiết lập BIDV đã chuyển chỗ. Mã đầu TK định danh và Mã dịch vụ không còn được nhập ở khối "BIDV Settings" của thiết lập Hóa đơn, cũng không nhập trên cổng thanh toán. Chúng thuộc về tài khoản ngân hàng BIDV của sổ nhật ký thanh toán, trong Kết nối ngân hàng BIDV. Bản nâng cấp sao chép giá trị mà cổng (hoặc công ty) đang giữ sang tài khoản ngân hàng BIDV, chỉ vào trường còn trống. Khối "BIDV Settings" giờ chỉ còn Mã bí mật, do Kết nối ngân hàng BIDV quản lý (xem tài liệu của mô-đun đó).
- Không còn công tắc "Enable QR Payment" và các bước EMV. Mã QR của trang thanh toán được tạo từ tài khoản ngân hàng của sổ nhật ký và số tài khoản thanh toán; bạn không cấu hình proxy EMV cho nó. Proxy chỉ cần cho mã QR in trên hóa đơn (xem ở trên).
- Có kiểm tra khi bật. BIDV không còn bật được với sổ nhật ký chưa đầy đủ: hệ thống liệt kê những gì còn thiếu, như mô tả ở trên.
- Số tiền được ghi nhận theo số thực nhận. Lần chuyển với số tiền khác được ghi theo số tiền thực nhận, số tiền yêu cầu được giữ ở Số tiền yêu cầu và có ghi chú trên chứng từ.
- Một mã BIDV, một khoản thanh toán. Bản nâng cấp ghi mã giao dịch BIDV của mọi giao dịch BIDV đã xác nhận vào một trường ngăn một mã thanh toán cho hai giao dịch. Nếu hai giao dịch cũ dùng chung một mã, chỉ giao dịch cũ nhất giữ mã đó.
Xử lý sự cố
Thông báo và cách xử lý
| Bạn thấy gì | Nguyên nhân | Cần làm gì |
|---|---|---|
| "Cổng thanh toán BIDV ... chưa thể được kích hoạt cho đến khi sổ nhật ký thanh toán của cổng này được thiết lập để thu tiền qua BIDV:" và một danh sách | Sổ nhật ký thanh toán chưa sẵn sàng; mỗi dòng nêu một mục còn thiếu. | Xem bảng trong mục "Khi hệ thống từ chối bật BIDV". |
| Khách thấy "Mã QR không khả dụng - vui lòng liên hệ ..." | Không tạo được mã QR: mã ngân hàng của BIDV không phải 6 chữ số, ngân hàng chưa có mã, Mã đầu TK định danh hoặc Mã dịch vụ còn trống, chủ tài khoản không có thành phố hay tỉnh/thành, hoặc số tài khoản thanh toán không bắt đầu bằng Mã đầu TK định danh của tài khoản ngân hàng. | Kiểm tra ngân hàng (970418), Mã đầu TK định danh, Mã dịch vụ và thành phố hoặc tỉnh/thành của chủ tài khoản. Khách vẫn có thể chuyển khoản đến số tài khoản được hiển thị. |
| Khách không thấy BIDV, hoặc thấy "không có phương thức thanh toán" | Cổng đang Đã tắt, Đã hủy hiển thị hoặc ở Chế độ kiểm thử; hoặc chứng từ không tính bằng VND, hoặc khách không ở Việt Nam. | Mở cổng thanh toán và kiểm tra Trạng thái và Đã hiển thị. |
| Khách không thanh toán lại được: hóa đơn hiện Đang chờ | Một khoản thanh toán BIDV đã được bắt đầu và chưa tất toán. | Khách mở lại hóa đơn (hoặc liên kết thanh toán) và thấy lại đúng hướng dẫn: mã QR, số tiền và số tài khoản. Nếu không được, số tài khoản chính là Tham chiếu của giao dịch (nút Giao dịch thanh toán trên hóa đơn). |
| Ghi chú "A BIDV payment of ... was attempted ... and refused ..." | BIDV được yêu cầu không nhận tiền; lý do nằm ngay sau. | Xem mục "Khi BIDV được yêu cầu không nhận tiền". |
| Ghi chú "BIDV payment ...: expected ..., received ..." | Khách đã trả một số tiền khác. | Kiểm tra Số tiền yêu cầu; phần còn lại của hóa đơn vẫn mở, hoặc phần thừa là số dư có. |
| Ghi chú "A second BIDV payment ... was refused" | Lần chuyển thứ hai, khác mã, cho chứng từ đã thanh toán. | Hỏi BIDV xem tiền đã được hoàn lại chưa; nếu tiền đã về tài khoản của bạn, hãy hoàn lại hoặc đối trừ bằng tay. |
| Ghi chú "BIDV payment ... was received after the transaction ... had been cancelled" | Tiền đến sau khi giao dịch đã bị hủy. | Đối trừ khoản thanh toán của khách với chứng từ khác hoặc hoàn tiền. |
| Giao dịch ở trạng thái Lỗi với thông báo "Khoản thanh toán BIDV ... không khớp với số tiền yêu cầu ... hãy ghi nhận thủ công." | Lần chuyển với số tiền khác trên một giao dịch không tính bằng đồng. | Đăng ký khoản thanh toán bằng tay. |
| Giao dịch ở trạng thái Lỗi với thông báo "BIDV đã gửi thông báo thanh toán không có mã giao dịch hoặc số tiền hợp lệ." hoặc "BIDV không thể thu giao dịch này: giao dịch không có số tiền cần thanh toán bằng VND." | Không dùng được thông báo của BIDV, hoặc chứng từ không có số tiền bằng đồng. | Xem cuộc gọi trong nhật ký callback (xem bên dưới) và hỏi BIDV hoặc đơn vị triển khai. |
Khách nói "tôi đã trả" nhưng hóa đơn chưa thanh toán
- Mở hóa đơn, nhấp Giao dịch thanh toán và đọc trạng thái. Đang chờ nghĩa là BIDV chưa thông báo đã nhận tiền.
- Xem các cuộc gọi BIDV đã thực hiện ở Nhật ký API ‣ Nhật ký yêu cầu API (xem tài liệu Kết nối ngân hàng BIDV: viin_bidv_connector). Một dòng BIDV paybill cho khoản thanh toán này nghĩa là BIDV đã thông báo; đọc mã trả lời của dòng đó.
- Nếu giao dịch đã Đã xác nhận mà hóa đơn vẫn chưa thanh toán, khoản thanh toán đang được tạo: hãy chờ hành động định kỳ "Thanh toán: Xử lý sau giao dịch" (mỗi 10 phút, hoạt động khi có một cổng thanh toán đang bật).
- Nếu không có dòng nào, BIDV chưa hề gọi được đến hệ thống: hãy kiểm tra địa chỉ và khóa cùng BIDV, như giải thích trong tài liệu Kết nối ngân hàng BIDV.
Hỏi đáp
- Tôi có dùng BIDV cho chứng từ bằng đô la Mỹ được không?
- Không. BIDV thu bằng đồng và cổng chỉ áp dụng cho VND.
- Vì sao số tiền ghi nhận khác với hóa đơn?
- Hệ thống ghi nhận số tiền BIDV đã nhận. Số tiền đã yêu cầu nằm ở Số tiền yêu cầu.
- Lý do BIDV từ chối một khoản thanh toán nằm ở đâu?
- Trong ghi chú trên hóa đơn hoặc đơn bán. Không màn hình nào khác hiển thị lý do này.
- Mã QR in trên hóa đơn của tôi có tự ghi nhận thanh toán không?
- Không. Chỉ mã QR trên trang thanh toán mới làm vậy.
Phần mềm này và các tệp liên kết ("Phần mềm") được sử dụng (chạy, tuỳ biến, chạy sau khi được tuỳ biến) chỉ khi bạn mua được giấy phép có hiệu lực từ tác giả, điển hình như qua các Ứng dụng Odoo, hoặc trong trường hợp bạn nhận được thoả thuận bằng văn bản từ tác giả của Phần mềm (chi tiết tại tệp COPYRIGHT).
Bạn có thể phát triển các phân hệ Odoo có sử dụng Phần mềm như một Thư viện (thường là phụ thuộc vào, nhập vào và sử dụng nguồn của nó) nhưng không sao chéo bất kỳ mã nguồn hay tài liệu nào thuộc Phần mềm. Bạn có thể phân phối những phân hệ này theo giấy phép mà bạn lựa chọn, miễn sao nội dung giấy phép đó tương tích với điều khoản của Giấy phép Phần mềm Độc quyền Odoo (ví dụ: LGPL, MIT hay bất kỳ loại giấy phép phần mềm độc quyền nào tương tự vậy).
Nghiêm cấm phát hành, phân phối, cấp phép lại hoặc bán bản sao của Phần mềm hoặc bản sao Phần mềm đã được sửa đổi.
Thông báo bản quyền và chấp thuận nêu trên buộc phải được bao gồm trong tất cả các bản sao hoặc các phần quan trọng của Phần mềm.
PHẦN MỀM ĐƯỢC CUNG CẤP "NGUYÊN TRẠNG", KHÔNG BẢO ĐẢM DƯỚI BẤT KỲ HÌNH THỨC NÀO, ĐƯỢC THỂ HIỆN RÕ RÀNG HOẶC NGỤ Ý, KHÔNG GIỚI HẠN ĐẢM BẢO VỀ CÁC BẢO ĐẢM NGỤ Ý VỀ KHẢ NĂNG THƯƠNG MẠI, PHÙ HỢP VỚI MỤC ĐÍCH CỤ THỂ VÀ KHÔNG VI PHẠM. TRONG MỌI TRƯỜNG HỢP SẼ KHÔNG CÓ TÁC GIẢ HOẶC CHỦ SỞ HỮU BẢN QUYỀN NÀO CHỊU TRÁCH NHIỆM VỀ BẤT KỲ KHIẾU NẠI, THIỆT HẠI HOẶC TRÁCH NHIỆM PHÁP LÝ KHÁC NÀO TRONG PHẠM VI HỢP ĐỒNG, CÁC THIỆT HẠI HOẶC CÁCH KHÁC, PHÁT SINH TỪ, NGOÀI HOẶC CÓ LIÊN KẾT VỚI PHẦN MỀM HOẶC VIỆC SỬ DỤNG HOẶC KINH DOANH KHÁC TẠI PHẦN MỀM.