Kết nối ngân hàng BIDV
| Số dòng Code | 1689 |
| Tên kỹ thuật | viin_bidv_connector |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/18.0/viin_bidv_connector |
| Đọ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 Ghi nhật ký API Request |
| Các mở rộng | Thanh toán QR Tự động BIDV |
Tài khoản BIDV của bạn, sẵn sàng cho biết mỗi khoản chuyển tiền trả cho chứng từ nào
Nhập Merchant ID và Service ID do BIDV cấp, gửi cho BIDV các địa chỉ callback và khóa hiển thị ngay trên tài khoản ngân hàng, và mọi lượt truy vấn hóa đơn, mọi thông báo thanh toán từ BIDV đều được ghi nhật ký - và được đối chiếu với khóa của công ty trước khi ứng dụng thanh toán xử lý.
Kết nối ngân hàng BIDV (tên kỹ thuật viin_bidv_connector) 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 qua tài khoản BIDV.
Tóm tắt nhanh
Dữ kiện về Kết nối ngân hàng BIDV, phiên bản 1.0.5, gom một chỗ. Phát hành bởi Viindoo.
Cách vận hành
Ba bước, làm một lần cho mỗi công ty.
Chọn BIDV cho tài khoản ngân hàng
Trên tài khoản ngân hàng của công ty, chọn BIDV ở trường Kết nối ngân hàng rồi nhập Mã đầu TK định danh BIDV (Merchant ID) và Mã dịch vụ BIDV (Service ID) trong hồ sơ đăng ký với BIDV. Quản trị viên hệ thống nhập App ID và Mã bí mật APP (App Secret), chọn môi trường Kiểm thử (Sandbox) hay Chính thức (Production) và bấm Kết nối.
Gửi cho BIDV những gì ngân hàng yêu cầu
URL tra cứu hóa đơn (getbill) và URL thông báo thanh toán (paybill), chứng chỉ và khóa đối xứng nằm ngay trên tài khoản ngân hàng đó, mỗi mục có nút sao chép. Mã bí mật nằm trong khối Thiết lập BIDV của thiết lập kế toán (Hóa đơn > Cấu hình > Thiết lập).
Theo dõi các lượt gọi từ BIDV
Mỗi lượt truy vấn hóa đơn và mỗi thông báo thanh toán để lại một dòng trong Nhật ký yêu cầu API, kèm câu trả lời hệ thống đã gửi.
Bạn nhận được gì
Mã đầu TK định danh BIDV (Merchant ID), Mã dịch vụ BIDV (Service ID), môi trường và thông tin bảo mật nằm trên chính tài khoản ngân hàng. Hai mã này là bắt buộc ngay khi chọn BIDV.
Ứng dụng tự phục vụ hai địa chỉ truy vấn hóa đơn và thông báo thanh toán của BIDV; hai địa chỉ cần gửi ngân hàng được hiển thị sẵn, không phải tự ghép.
Các ứng dụng ghi nhận thanh toán đối chiếu checksum của BIDV với khóa của công ty thông qua ứng dụng kết nối; lượt gọi không khớp bị từ chối trước khi hệ thống tra cứu hay thay đổi bất cứ chứng từ nào.
Dù được chấp nhận hay bị từ chối, mỗi callback đều để lại một dòng; checksum được che trong nhật ký.
Mã bí mật, chứng chỉ và khóa đối xứng được tạo cho từng công ty, chỉ quản trị viên hệ thống nhìn thấy; khóa riêng không xuất hiện trên màn hình nào.
Mã QR mang định danh thanh toán (alias) của BIDV thay cho số tài khoản trần, nhờ đó BIDV báo được cho hệ thống khoản chuyển tiền trả cho chứng từ nào - và thiết lập còn thiếu được báo bằng thông điệp rõ ràng thay vì một mã QR 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.
Khi cài riêng lẻ, ứng dụng trả lời BIDV rằng không tìm thấy hóa đơn. Thanh toán QR Tự động BIDV ghi nhận tiền lên hóa đơn và đơn bán; Điểm bán lẻ - Tự động thanh toán mã QR với BIDV làm việc đó tại quầy.
Merchant ID, Service ID, App ID và App Secret do BIDV cấp.
Chỉ mã bí mật tạo lại được từ phần thiết lập.
Mã QR cần mã định danh NAPAS của ngân hàng và tỉnh/thành phố của chủ tài khoản.
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:
Thanh toán QR Tự động BIDV
Ghi nhận từng khoản chuyển tiền đã xác nhận lên hóa đơn hoặc đơn bán tương ứng.
payment_bidv_viinĐiểm bán lẻ - Tự động thanh toán mã QR với BIDV
Hiển thị mã QR BIDV tại quầy và chốt đơn khi BIDV xác nhận.
viin_pos_qr_bidvAi nên dùng Kết nối ngân hàng BIDV?
Quản trị viên hệ thống
Kết nối tài khoản một lần, lấy địa chỉ và khóa gửi BIDV từ một màn hình, và giữ khóa kín với người dùng khác.
Kế toán
Nhập Mã đầu TK định danh BIDV và Mã dịch vụ BIDV, và xem được BIDV đã gọi tới hệ thống hay chưa, được trả lời thế nào.
Câu hỏi thường gặp
Kết nối ngân hàng BIDV làm gì?
Ứng dụng nối tài khoản BIDV của công ty với BIDV Open API: lưu Merchant ID và Service ID, hiển thị địa chỉ callback và khóa cần gửi BIDV, tạo mã VietQR kèm định danh thanh toán, tiếp nhận các lượt truy vấn hóa đơn và thông báo thanh toán của BIDV, ghi nhật ký từng lượt, và cung cấp cho các ứng dụng thanh toán phép kiểm tra checksum mà chúng dựa vào.
Kết nối ngân hàng BIDV không làm gì?
Ứng dụng không tự ghi nhận thanh toán lên hóa đơn, đơn bán hay đơn POS; cần thêm Thanh toán QR Tự động BIDV hoặc Điểm bán lẻ - Tự động thanh toán mã QR với BIDV. Ứng dụng không thay cho việc đăng ký BIDV Open API.
Kết nối ngân hàng BIDV dành cho ai?
Doanh nghiệp tại Việt Nam thu tiền qua tài khoản BIDV: quản trị viên hệ thống thiết lập kết nối và kế toán theo dõi việc thu tiền.
Địa chỉ để BIDV gọi tới nằm ở đâu?
Trên tài khoản ngân hàng của công ty, trong phần BIDV: URL tra cứu hóa đơn (getbill) và URL thông báo thanh toán (paybill), mỗi địa chỉ có nút sao chép.
Ai xem được khóa và mã bí mật?
Chỉ quản trị viên hệ thống. Khóa riêng không hiển thị trên bất kỳ màn hình nào.
Làm sao biết BIDV đã gọi tới hệ thống?
Mở Nhật ký yêu cầu API: mỗi lượt gọi từ BIDV là một dòng mang tên callback, kèm trạng thái của câu trả lời.
Chúng tôi đã cấu hình BIDV trên Odoo 17 - khi nâng cấp thì khóa ra sao?
Bản nâng cấp sao chép chứng chỉ, khóa riêng và khóa đối xứng đang lưu trên các tài khoản ngân hàng BIDV sang công ty và chỉ tạo mới phần còn thiếu; khóa công ty đã có không bao giờ bị ghi đè.
Thiết lập như thế nào?
Chọn BIDV trên tài khoản ngân hàng của công ty, nhập Mã đầu TK định danh BIDV và Mã dịch vụ BIDV, để quản trị viên hệ thống nhập App ID, Mã bí mật APP rồi bấm Kết nối, sau đó gửi cho BIDV hai địa chỉ callback, chứng chỉ, khóa đối xứng và mã bí mật.
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: viin_bank_connector, l10n_vn. 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?
Thanh toán QR Tự động BIDV (payment_bidv_viin): Ghi nhận từng khoản chuyển tiền đã xác nhận lên hóa đơn hoặc đơn bán tương ứng. Điểm bán lẻ - Tự động thanh toán mã QR với BIDV (viin_pos_qr_bidv): Hiển thị mã QR BIDV tại quầy và chốt đơn khi BIDV xác nhận. Kết nối ngân hàng (viin_bank_connector): Nền tảng dùng chung, được cài cùng ứng dụng nà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 viin_bidv_connector; câu hỏi trước bán hàng gửi sales@viindoo.com.
Xem Kết nối ngân hàng BIDV vận hành
Live demo: v18demo-vn.viindoo.com
Cần hỗ trợ về Kết nối ngân hà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
1.0.5 - Odoo 18.0
- Khối Mã bí mật trong phần thiết lập được bố trí gọn gàng.
- Việc kiểm tra chữ ký trong phản hồi của BIDV (tùy chọn) nay từ chối cả chữ ký sai định dạng, không chỉ chữ ký bị thiếu.
1.0.4 - Odoo 18.0
- Ứng dụng tự phục vụ các callback của BIDV và hiển thị hai địa chỉ trên tài khoản ngân hàng.
- Mọi callback được ghi nhật ký với checksum đã che.
- Khóa được lưu theo công ty, chỉ quản trị viên hệ thống nhìn thấy, và được chuyển từ tài khoản ngân hàng sang khi nâng cấp.
- Mã VietQR báo thiết lập còn thiếu bằng thông điệp rõ ràng.
1.0.2 - Odoo 18.0
- Bản phát hành đầu tiên cho Odoo 18.0.
Kết nối ngân hàng BIDV
Note
Mở rộng từ Kết nối ngân hàng - xem tài liệu của mô-đun này: viin_bank_connector.
Tổng quan
Kết nối ngân hàng BIDV nối tài khoản ngân hàng của công ty tại BIDV với hệ thống của bạn. Mô-đun làm bốn việc:
- Tạo mã VietQR của tài khoản kèm bí danh thanh toán BIDV, để BIDV biết khách đang thanh toán cho hóa đơn nào.
- Cung cấp hai địa chỉ web mà BIDV gọi đến: một địa chỉ để tra cứu hóa đơn (URL tra cứu hóa đơn) và một địa chỉ để thông báo thanh toán (URL thông báo thanh toán). Bạn không cần cài thêm ứng dụng nào khác để hai địa chỉ này hoạt động.
- Ghi nhật ký mọi cuộc gọi của BIDV trong Nhật ký yêu cầu API.
- Tạo và bảo vệ các khóa của công ty mà BIDV cần: chứng chỉ, khóa đối xứng và mã bí mật.
Mô-đun này không tự ghi nhận thanh toán. Cài riêng một mình, nó trả lời yêu cầu tra cứu hóa đơn là "khách hàng không tồn tại" (mã kết quả 011) và trả lời thông báo thanh toán là "không tìm thấy hóa đơn" (mã kết quả 021). Để thanh toán được ghi nhận, bạn cần cài thêm một trong các ứng dụng sau:
- Thanh toán QR Tự động BIDV cho hóa đơn và đơn bán.
- Điểm bán lẻ - Tự động thanh toán mã QR với BIDV cho quầy thu ngân.
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 | Kết nối tài khoản với BIDV (Mã bí mật APP, nút Kết nối), cung cấp cho BIDV các địa chỉ, mã bí mật, chứng chỉ và khóa đối xứng, xem các khóa. | Quản trị / Thiết lập |
| Nhân viên kế toán | Mở tài khoản ngân hàng của công ty, chọn BIDV ở Kết nối ngân hàng, nhập Mã đầu TK định danh BIDV và Mã dịch vụ BIDV, xem các địa chỉ callback. | Quyền Bổ sung / Tạo Liên hệ |
| Nhân viên kế toán hoặc hỗ trợ CNTT | Kiểm tra BIDV có gọi được đến hệ thống không và hệ thống đã trả lời gì. | Trình xem nhật ký API (xem mục "Kiểm tra BIDV có gọi được đến hệ thống") |
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
Hãy xin BIDV bốn giá trị BIDV cấp cho công ty bạn: Mã đầu TK định danh (Merchant ID), Mã dịch vụ (Service ID), App ID và Mã bí mật APP (App Secret). Sau đó kiểm tra hai điều sau, vì thiếu chúng thì không tạo được mã QR:
- Ngân hàng. Mở Danh bạ ‣ Cấu hình ‣ Tài khoản ngân hàng ‣ Ngân hàng, mở BIDV và kiểm tra Mã định danh ngân hàng là mã NAPAS 6 chữ số của BIDV: 970418. Mã SWIFT không dùng được.
- Chủ tài khoản. Chủ tài khoản (liên hệ của công ty bạn) phải có Thành phố hoặc Tỉnh/TP. Mở Danh bạ ‣ Danh bạ, mở công ty của bạn và điền Thành phố hoặc Tỉnh/TP.
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 Kết nối ngân hàng BIDV.
- Nhấp Cài đặt. Ứng dụng Kết nối ngân hàng và bản địa hóa kế toán Việt Nam được cài cùng.
- Cài thêm Thanh toán QR Tự động BIDV và/hoặc Điểm bán lẻ - Tự động thanh toán mã QR với BIDV nếu bạn muốn thanh toán được ghi nhận.
Khi mô-đun được cài, công ty của bạn tự động có mã bí mật, chứng chỉ và khóa đối xứng. Công ty tạo sau này cũng được tạo các khóa này.
Gán quyền làm việc với BIDV cho người dùng
Mở Thiết lập ‣ Người dùng & Công ty ‣ Người dùng, mở người dùng và tích vào quyền truy cập trong bảng trên:
- Quản trị / Thiết lập cho quản trị viên.
- Quyền Bổ sung / Tạo Liên hệ cho nhân viên kế toán.
- Trình xem nhật ký API cho người đọc Nhật ký yêu cầu API. Quyền này nằm trong nhóm "Kỹ thuật" và chỉ hiển thị khi bật chế độ nhà phát triển.
Kết nối tài khoản ngân hàng
Nhân viên kế toán và quản trị viên cùng thực hiện việc này. Cần quản trị viên cho Mã bí mật APP và nút Kết nối.
- Mở Danh bạ ‣ Cấu hình ‣ Tài khoản ngân hàng ‣ Tài khoản ngân hàng và mở tài khoản của công ty tại BIDV (hoặc tạo mới, với ngân hàng là BIDV).
- Trong nhóm "Kết nối ngân hàng", chọn BIDV ở Kết nối ngân hàng.
- Chọn Môi trường: Kiểm thử để chạy thử, Chính thức để dùng ngân hàng thật.
- Nhập App ID do BIDV cấp.
- Nhập Mã bí mật APP (chỉ quản trị viên - người dùng khác không thấy trường này).
- Trong nhóm "BIDV", nhập Mã đầu TK định danh BIDV và Mã dịch vụ BIDV. Cả hai đều bắt buộc.
- Nhấp Lưu.
- Quản trị viên nhấp Kết nối.
Nhân viên kế toán thấy cùng biểu mẫu nhưng không có Mã bí mật APP, Chứng chỉ và Khóa đối xứng:
Quản trị viên thấy toàn bộ biểu mẫu:
Nút Kết nối phản hồi như sau:
- Thành công: thông báo "Kết nối BIDV OPEN API thành công" kèm nội dung "Hãy bắt đầu sử dụng BIDV OPEN API."
- Nếu App ID hoặc Mã bí mật APP để trống: "App ID và App Secret cần để kết nối BIDV".
- Nếu BIDV từ chối hoặc không trả lời: "Lỗi khi kết nối BIDV:" kèm lý do BIDV đưa ra, hoặc "no response".
- Nếu bạn không phải quản trị viên, hệ thống từ chối bằng lỗi quyền truy cập trước khi gọi BIDV. Hãy nhờ quản trị viên nhấp nút.
Hệ thống tự xin BIDV mã truy cập mới khi mã đang thiếu hoặc hết hạn, vì vậy bạn nhấp Kết nối để kiểm tra thông tin xác thực, không phải để gia hạn.
Cung cấp thông tin phía bạn cho BIDV
BIDV cần năm mục từ bạn. Tất cả đều có trong hệ thống:
| Mục gửi BIDV | Nơi tìm | Ai thấy |
|---|---|---|
| URL tra cứu hóa đơn | Biểu mẫu tài khoản ngân hàng, nhóm "BIDV" | Kế toán và quản trị viên |
| URL thông báo thanh toán | Biểu mẫu tài khoản ngân hàng, nhóm "BIDV" | Kế toán và quản trị viên |
| Chứng chỉ | Biểu mẫu tài khoản ngân hàng, nhóm "BIDV" | Quản trị viên |
| Khóa đối xứng | Biểu mẫu tài khoản ngân hàng, nhóm "BIDV" | Quản trị viên |
| Mã bí mật | Hóa đơn ‣ Cấu hình ‣ Thiết lập, khối "Thiết lập BIDV" | Quản trị viên |
Hai địa chỉ kết thúc bằng /bidv/qrcode/getbill và /bidv/qrcode/paybill. Chính mô-đun này cung cấp hai địa chỉ đó. Chúng bắt đầu bằng địa chỉ web của hệ thống, nên hãy kiểm tra chúng hiển thị địa chỉ công khai mà BIDV truy cập được, không phải địa chỉ nội bộ như localhost. Nếu không đúng, hãy nhờ đơn vị triển khai sửa địa chỉ web của hệ thống.
Mỗi trường có nút sao chép ở bên phải. Nhấp nút này rồi dán giá trị vào biểu mẫu hoặc thư gửi BIDV.
Chứng chỉ là thông tin công khai: ảnh chỉ hiện dòng đầu, còn BIDV cần toàn bộ nội dung. Không gửi Mã bí mật hoặc Khóa đối xứng qua kênh mở; hãy dùng kênh bảo mật đã thống nhất với BIDV.
Trong nhóm "BIDV" còn có Chứng chỉ công khai BIDV. Hãy dán vào đó chứng chỉ BIDV cung cấp. Trường này chỉ được dùng nếu bạn bật việc kiểm tra chữ ký của BIDV (xem mục "Tùy chọn: kiểm tra chữ ký trong phản hồi của BIDV").
Mã bí mật
Mã bí mật thuộc về công ty bạn đang làm việc. Chỉ nhấp Tạo mã bí mật khi mã bị lộ hoặc BIDV yêu cầu mã mới. Hệ thống sẽ hỏi xác nhận trước: "Việc tạo mã bí mật mới sẽ khiến BIDV từ chối mọi callback cho đến khi mã bí mật mới được chia sẻ với BIDV. Tiếp tục?". Sau khi xác nhận, mã mới thay thế mã cũ ngay và trang hiện "Mã bí mật mới đã được tạo. Vui lòng sao chép và chia sẻ với BIDV." Từ lúc đó BIDV từ chối mọi cuộc gọi cho đến khi bạn gửi cho BIDV mã mới.
Kiểm tra BIDV có gọi được đến hệ thống
Mỗi cuộc gọi của BIDV đến hai địa chỉ trên để lại một dòng trong Nhật ký API ‣ Nhật ký yêu cầu API. Menu này hiển thị cho người dùng có quyền Trình xem nhật ký API (chỉ đọc) và cho quản trị viên (đọc và xóa).
Cách đọc một dòng:
- Tên: BIDV getbill là tra cứu hóa đơn, BIDV paybill là thông báo thanh toán.
- URL: địa chỉ BIDV đã gọi.
- Trạng thái phản hồi: luôn là 200. Mã trả lời của BIDV không nằm ở đây mà nằm trong nội dung trả lời, xem bên dưới.
- Thông báo lỗi: chỉ có khi hệ thống gặp sự cố lúc xử lý cuộc gọi; nó nêu loại sự cố.
- Bản ghi: đơn hàng, hóa đơn hoặc khoản thanh toán mà cuộc gọi liên quan, khi một ứng dụng thanh toán cung cấp.
Mở một dòng và nhấp thẻ "Chi tiết phản hồi" để đọc câu trả lời đã gửi cho BIDV.
Nội dung được lưu trong một dòng:
- Với cuộc gọi đã qua bước kiểm tra chữ ký: nội dung cuộc gọi (checksum được che) và câu trả lời.
- Với mọi cuộc gọi khác: chỉ có kích thước cuộc gọi và mã trả lời. Không lưu gì thêm về cuộc gọi.
Một mình mô-đun này không bao giờ coi cuộc gọi là "hợp lệ", nên khi chưa cài ứng dụng thanh toán, mọi dòng chỉ có kích thước. Nội dung đầy đủ chỉ xuất hiện khi một ứng dụng thanh toán kiểm tra cuộc gọi.
Ý nghĩa của mã trả lời:
| Mã | Ý nghĩa | Việc cần làm |
|---|---|---|
| 000 | Thành công. | Không cần làm gì. |
| 011 | Khách hàng không tồn tại (Mã khách hàng không đúng/không tồn tại). | BIDV hỏi về một bí danh thanh toán mà hệ thống chưa trả lời được. Nếu chưa cài ứng dụng thanh toán thì đây là điều bình thường: hãy cài một ứng dụng. Nếu đã cài, kiểm tra Mã đầu TK định danh trên tài khoản ngân hàng có đúng như BIDV dùng không. |
| 021 | Không tìm thấy hóa đơn (Mã hóa đơn không tồn tại). | Một khoản thanh toán được thông báo nhưng không khớp được chứng từ nào. Kiểm tra như mã 011. |
| 023 | Giao dịch đã được gạch nợ. | BIDV thông báo một khoản thanh toán đã được ghi nhận. Không cần làm gì. |
| 004 | Checksum không hợp lệ. | Do các ứng dụng thanh toán trả về khi checksum của cuộc gọi không khớp. Mã bí mật hoặc Khóa đối xứng BIDV đang dùng khác với giá trị trong hệ thống: hãy gửi lại cho BIDV các giá trị hiện hành. |
| 031 | Có lỗi phát sinh từ hệ thống. | Cuộc gọi bị lỗi bên trong hệ thống. Đọc cột Thông báo lỗi và nhờ đơn vị triển khai hỗ trợ. |
Các khóa và ai được xem
- Mã bí mật, chứng chỉ, khóa riêng và khóa đối xứng được tạo tự động cho từng công ty: khi cài mô-đun, khi tạo công ty mới và khi nâng cấp mô-đun. Giá trị đã có không bao giờ bị thay thế.
- Chỉ quản trị viên hệ thống thấy Chứng chỉ, Khóa đối xứng và Mã bí mật, và chỉ với những công ty họ được phép làm việc. Người dùng khác không thấy các trường này.
- Khóa riêng không hiển thị trên bất kỳ màn hình nào.
- Chứng chỉ có hiệu lực 365 ngày kể từ ngày tạo. Ở chế độ nhà phát triển, trường Thông tin chứng chỉ trên tài khoản ngân hàng hiển thị chủ thể, số sê-ri, ngày bắt đầu và ngày hết hiệu lực.
- Phiên bản này không có nút để gia hạn chứng chỉ hoặc khóa đối xứng. Khi chứng chỉ sắp hết hạn, hoặc khi cần thay khóa đối xứng, hãy liên hệ đơn vị triển khai hoặc bộ phận hỗ trợ của Viindoo.
Tùy chọn: kiểm tra chữ ký trong phản hồi của BIDV
Mặc định, hệ thống không kiểm tra chữ ký trong phản hồi của BIDV cho các cuộc gọi do hệ thống thực hiện. Để bắt buộc kiểm tra, quản trị viên bật chế độ nhà phát triển, mở Thiết lập ‣ Kỹ thuật ‣ Tham số ‣ Thông số hệ thống và tạo một thông số có khóa viin_bank_connector.verify_jws và giá trị True. Thông số này không có sẵn sau khi cài đặt. Khi đã đặt:
- Phản hồi của BIDV phải có chữ ký; nếu chữ ký bị thiếu hoặc sai định dạng, hệ thống báo "Phản hồi từ BIDV không có chữ ký nên không thể xác minh chữ ký."
- Chữ ký được kiểm tra bằng Chứng chỉ công khai BIDV của tài khoản ngân hàng. Nếu kiểm tra thất bại, hệ thống báo "Xác minh chữ ký JWS thất bại:" kèm lý do.
Việc này áp dụng cho các cuộc gọi do ứng dụng thanh toán thực hiện đến BIDV. Nó không thay đổi cách kiểm tra cuộc gọi của BIDV đến bạn. Xóa thông số hoặc đặt giá trị False để tắt kiểm tra.
Nâng cấp từ Odoo 17
Trên 17.0, các khóa được lưu trên tài khoản ngân hàng BIDV. Khi nâng cấp mô-đun lên 18.0, với mỗi công ty, quá trình nâng cấp làm như sau:
- Nếu công ty chưa có chứng chỉ và khóa riêng, sao chép cặp này từ tài khoản BIDV cũ nhất của liên hệ công ty có đủ cả hai.
- Nếu công ty chưa có khóa đối xứng, sao chép từ tài khoản BIDV cũ nhất có khóa này.
- Tạo những gì còn thiếu: chứng chỉ và khóa riêng, khóa đối xứng, và mã bí mật nếu công ty chưa có.
Khóa mà công ty đã có không bao giờ bị ghi đè. Nếu quá trình nâng cấp tạo mã bí mật hoặc khóa mới, hãy gửi cho BIDV, nếu không BIDV sẽ từ chối các cuộc gọi.
Xử lý sự cố
Không tạo được mã QR
Khi không tạo được mã QR, lý do là một trong các thông báo sau:
| Thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| Thiếu thành phố hoặc tỉnh/thành của người bán. | Chủ tài khoản không có Thành phố lẫn Tỉnh/TP. | Điền Thành phố hoặc Tỉnh/TP cho liên hệ của công ty bạn. |
| Thiếu Mã định danh ngân hàng. | Ngân hàng của tài khoản chưa có Mã định danh ngân hàng. | 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. |
| Mã định danh ngân hàng phải là mã BIN NAPAS 6 chữ số (BIDV là 970418), không phải mã SWIFT. | Mã trên ngân hàng không phải sáu chữ số. | Thay bằng 970418. |
| Thiếu Mã đầu TK định danh BIDV hoặc Mã dịch vụ BIDV. | Một trong hai để trống trên tài khoản ngân hàng. | Nhập cả hai trong nhóm "BIDV". |
| Bí danh thanh toán phải bắt đầu bằng Mã đầu TK định danh BIDV. | Mã tham chiếu thanh toán của chứng từ không bắt đầu bằng Mã đầu TK định danh của tài khoản. | Kiểm tra Mã đầu TK định danh được nhập đúng như BIDV cấp, và ứng dụng thanh toán dùng đúng tài khoản này. |
| Thiếu thông tin tài khoản người bán. | Không dựng được thông tin tài khoản của mã QR. | Kiểm tra ngân hàng và Mã đầu TK định danh của tài khoản, rồi nhờ đơn vị triển khai hỗ trợ. |
Kết nối với BIDV bị lỗi
| Thông báo | Nguyên nhân | Cách xử lý |
|---|---|---|
| App ID và App Secret cần để kết nối BIDV | Một trong hai để trống. | Nhập cả hai (Mã bí mật APP do quản trị viên nhập), lưu, nhấp Kết nối. |
| Lỗi khi kết nối BIDV: ... | BIDV từ chối thông tin xác thực hoặc không truy cập được. Phần sau dấu hai chấm là lý do BIDV đưa ra, hoặc "no response". | Kiểm tra App ID và Mã bí mật APP, kiểm tra Môi trường có khớp với thông tin xác thực (Kiểm thử hoặc Chính thức), rồi thử lại. |
| Lỗi khi gọi BIDV API: ... | Một cuộc gọi do ứng dụng thanh toán thực hiện bị từ chối hoặc không có phản hồi. | Nhấp Kết nối để kiểm tra thông tin xác thực, rồi đọc lý do sau dấu hai chấm. |
| BIDV từ chối mọi cuộc gọi sau khi bạn tạo mã bí mật mới | BIDV vẫn giữ mã bí mật cũ. | Gửi cho BIDV Mã bí mật hiện hành. |
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.