Thanh toán trực tuyến Ngân Lượng
| Số dòng Code | 1021 |
| Tên kỹ thuật | payment_nganluong |
| Giấy phép | OPL-1 |
| Website | https://viindoo.com/apps/modules/19.0/payment_nganluong |
| Đọc mô tả cho | v 12.0 v 13.0 v 14.0 v 15.0 v 16.0 v 17.0 v 18.0 |
| Yêu cầu các App | Invoicing (account) Discuss (mail) |
| Bao gồm Các phụ thuộc | Mô-đun Cơ Sở Nền tảng Kế toán Quy đổi Tiền tệ cho Cổng Thanh toán |
Để khách thanh toán qua Ngân Lượng - và không bỏ sót khoản nào, kể cả khi thông báo bị thất lạc
Dành cho doanh nghiệp bán hàng và cung cấp dịch vụ trực tuyến tại Việt Nam, thu tiền bằng VND trên đơn hàng và hóa đơn
Tích hợp thanh toán trực tuyến với Ngân Lượng
Bạn có đang gặp những điều này?
Khách chuyển khoản và nhân viên phải đối chiếu từng khoản với đơn hàng bằng tay.
Bạn gửi link thanh toán nhưng hệ thống không cho biết ai đã thực sự trả tiền.
Khách nói đã thanh toán mà đơn hàng vẫn hiện chưa trả.
Khoản thanh toán bị cổng giữ lại chỉ được phát hiện khi có người đăng nhập kiểm tra.
Bạn cần xác nhận không thể bị giả mạo bằng cách sửa đường link.
Điều gì thay đổi
Đối chiếu chuyển khoản thủ công
→ Khách thanh toán bằng mã QR, thẻ ATM hoặc thẻ quốc tế trên trang Ngân Lượng, khoản tiền tự ghi nhận khi Ngân Lượng thông báo cho Odoo.
Link thanh toán không có dấu vết
→ Thanh toán từ đơn hàng hoặc hóa đơn và theo dõi từng khoản qua các trạng thái Draft, Pending, Confirmed, Canceled, Error.
Tranh cãi "tôi trả rồi"
→ Mọi khoản thanh toán được xác nhận với chính Ngân Lượng trước khi ghi nhận.
Thông báo bị thất lạc
→ Mỗi khoản thanh toán theo đúng báo cáo của Ngân Lượng về đơn hàng.
Khoản bị giữ bị quên
→ Khoản bị giữ ở trạng thái chờ kèm thông báo; hãy kiểm tra việc giải phóng trên cổng Ngân Lượng.
Cách hoạt động
Quản trị viên IT kết nối Ngân Lượng.
Nhập merchant ID, mật khẩu và email nhận tiền, rồi chọn có chấp nhận ngay các khoản bị giữ hay không.
Nhân viên công nợ phải thu gửi thanh toán.
Tạo link thanh toán trực tuyến từ đơn bán hoặc hóa đơn, hoặc để khách thanh toán ngay khi đặt hàng trên website.
Khách thanh toán trên Ngân Lượng.
Khách có tối đa 24 giờ trên trang Ngân Lượng để thanh toán bằng mã QR, thẻ ATM hoặc thẻ quốc tế, rồi quay lại cửa hàng.
Odoo xác nhận.
Thanh toán được ghi nhận khi Ngân Lượng thông báo cho Odoo, hoặc khi khách quay lại, sau khi Odoo hỏi Ngân Lượng về kết quả.
Cập nhật từ Ngân Lượng.
Khi khách quay lại hoặc Ngân Lượng gửi thông báo, Odoo hỏi Ngân Lượng báo cáo của đơn hàng và cập nhật khoản thanh toán.
Tính năng nổi bật
Thanh toán trên trang Ngân Lượng
Khách thanh toán bằng VND qua mã QR, thẻ ATM hoặc thẻ quốc tế trên trang Ngân Lượng, được Odoo mở từ đơn hàng hoặc hóa đơn.
Thanh toán tự động được ghi nhận
Khoản thanh toán thành công được ghi nhận khi Ngân Lượng thông báo cho Odoo; thông báo không có mã truy cập hợp lệ bị bỏ qua.
Link quay về không bao giờ được tin
Sau khi thanh toán hoặc hủy, khách quay lại Odoo và trạng thái được lấy lại từ chính câu trả lời của Ngân Lượng, không từ đường link.
Đối chiếu đơn trước khi xác nhận
Khoản thanh toán chỉ được xác nhận khi Ngân Lượng báo đúng mã đơn, đúng mã thông báo và đúng email người nhận của bạn.
Xử lý rõ ràng khoản bị giữ
Khoản Ngân Lượng giữ lại ở trạng thái chờ kèm thông báo, hoặc được chấp nhận ngay nếu bạn chọn.
Bảo vệ thông tin merchant
Merchant ID và mật khẩu chỉ quản trị viên nhìn thấy, không bị sao chép khi nhân bản cổng thanh toán và được xóa trong bản sao cơ sở dữ liệu đã vô hiệu hóa.
Dành cho ai
Chủ doanh nghiệp hoặc giám đốc tài chính
Bạn muốn khách thanh toán trực tuyến và tiền được xác nhận mà không tốn công nhân viên. Thanh toán được tự ghi nhận từ thông báo của Ngân Lượng và khi khách quay lại.
Trưởng nhóm hoặc nhân viên công nợ phải thu
Bạn gửi link thanh toán và xử lý các trường hợp ngoại lệ. Mỗi khoản hiển thị trạng thái, khoản bị giữ có thông báo rõ ràng.
Quản trị viên IT
Bạn cần thông tin xác thực an toàn. Merchant ID và mật khẩu chỉ quản trị viên nhìn thấy, không bị sao chép khi nhân bản cổng thanh toán và được xóa trong bản sao cơ sở dữ liệu đã vô hiệu hóa.
Phù hợp nhất với: doanh nghiệp bán hàng và dịch vụ trực tuyến tại Việt Nam nhận thanh toán VND qua Ngân Lượng và muốn khoản tiền được xác nhận, ghi nhận trong Odoo mà không cần theo dõi thủ công.
Kết nối tài khoản merchant Ngân Lượng
Chọn cách xử lý khoản bị giữ
Câu hỏi thường gặp
Nếu thông báo từ Ngân Lượng không bao giờ đến thì sao?
Khi khách quay lại cửa hàng, Odoo hỏi Ngân Lượng báo cáo của đơn hàng, nên khoản thanh toán vẫn được ghi nhận. Ngoài ra, hãy bảo đảm Ngân Lượng truy cập được địa chỉ website của bạn.
Khách có giả mạo thanh toán bằng link quay về được không?
Không. Link quay về và link hủy không bao giờ được tin; Odoo hỏi Ngân Lượng để lấy trạng thái thật. Thông báo không có mã truy cập hợp lệ bị bỏ qua.
Khoản thanh toán Ngân Lượng giữ lại thì sao?
Khoản đó ở trạng thái chờ kèm thông báo: Ngân Lượng không báo khi giải phóng, nên hãy kiểm tra việc giải phóng trên cổng Ngân Lượng. Nếu muốn, bật "Chấp nhận thanh toán bị giữ" (Accept Detained Payments) để chấp nhận ngay. Mặc định tùy chọn này tắt.
Tôi có hoàn tiền được từ Odoo không?
Không. Odoo không cung cấp hoàn tiền cho Ngân Lượng; hãy xử lý trực tiếp với Ngân Lượng.
Hỗ trợ loại tiền nào?
VND, cho khách hàng tại Việt Nam. Với hóa đơn hoặc đơn hàng bằng loại tiền khác, quản trị viên có thể bật bằng cách đặt Tiền tệ chuyển đổi mặc định của cổng thanh toán là VND, dựa trên module chênh lệch tiền tệ mà ứng dụng này yêu cầu.
Có tự động bật không?
Không. Phương thức thanh toán Ngân Lượng ở trạng thái không hoạt động cho đến khi bạn kích hoạt.
Cần hỗ trợ về Thanh toán trực tuyến Ngân Lượng?
Hỗ trợ kỹ thuật
apps.support@viindoo.comYêu cầu kỹ thuật
- Phiên bản Odoo: 19.0
- Ấn bản: Odoo Community, Odoo Enterprise
- Module yêu cầu: payment, to_currency_conversion_diff
- Giấy phép: OPL-1
Cổng thanh toán Ngân Lượng
Tổng quan
Khách hàng tại Việt Nam thích thanh toán trực tuyến bằng các công cụ họ vẫn dùng hằng ngày. Module này thêm Ngân Lượng làm cổng thanh toán trong Odoo. Khách hàng thanh toán đơn bán hàng, hóa đơn hoặc đường dẫn thanh toán trên trang thanh toán của Ngân Lượng bằng mã QR, thẻ ATM hoặc thẻ quốc tế, và Odoo tự động ghi nhận từng khoản thanh toán đã được xác nhận.
Một khoản thanh toán Ngân Lượng đi qua doanh nghiệp như thế nào
- Khách hàng chọn Ngân Lượng khi thanh toán (hoặc mở đường dẫn thanh toán do doanh nghiệp gửi) và được chuyển đến trang thanh toán của Ngân Lượng. Khoản thanh toán ở trạng thái Nháp trong Odoo.
- Nếu Ngân Lượng tạm giữ tiền trong vài ngày, khoản thanh toán ở trạng thái Đang chờ. Nhân viên công nợ phải thu theo dõi cho đến khi Ngân Lượng giải ngân.
- Khi Ngân Lượng xác nhận khoản thanh toán, Odoo chuyển sang Đã xác nhận và khách hàng quay lại cửa hàng của bạn.
- Nếu khách hàng hủy trên trang của Ngân Lượng, khoản thanh toán chuyển sang Đã hủy.
- Nếu Ngân Lượng từ chối đơn, hoặc đơn mà Ngân Lượng báo về không phải đơn Odoo đã gửi, khoản thanh toán chuyển sang Lỗi kèm một thông báo. Nhân viên công nợ phải thu tìm hiểu nguyên nhân.
Ai sử dụng module 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 / CNTT | Cài đặt module, nhập ID người bán, mật khẩu và email người nhận của Ngân Lượng, và quyết định có chấp nhận ngay các khoản thanh toán đang bị Ngân Lượng tạm giữ hay không. | Quản trị / Cài đặt |
| Nhân viên công nợ phải thu | Gửi đường dẫn thanh toán trực tuyến từ đơn bán hàng hoặc hóa đơn, và theo dõi các khoản thanh toán còn đang chờ hoặc bị lỗi. | Người dùng nội bộ làm việc với thanh toán của khách hàng |
| Khách hàng | Thanh toán đơn hàng hoặc hóa đơn trên trang của Ngân Lượng rồi quay lại cửa hàng. | Không có (khách hàng không cần quyền truy cập Odoo) |
Note
Ngân Lượng chỉ nhận thanh toán bằng Đồng Việt Nam (VND) và chỉ hiển thị cho khách hàng có quốc gia là Việt Nam. Xem phần Câu hỏi thường gặp đối với chứng từ dùng loại tiền khác.
Thiết lập (dành cho Quản trị viên hệ thống / CNTT)
Cài đặt
- Mở Ứng dụng.
- Xóa bộ lọc mặc định và tìm Thanh toán trực tuyến Ngân Lượng.
- Nhấn Cài đặt.
Module cũng cài đặt các tính năng của Thanh toán mà nó cần và ứng dụng Quy đổi Tiền tệ cho Cổng Thanh toán.
Lấy thông tin đăng nhập Ngân Lượng
Đăng nhập tài khoản người bán Ngân Lượng của bạn và ghi lại ba giá trị:
- mã người bán (ID người bán) của tích hợp,
- mật khẩu người bán của tích hợp,
- email của tài khoản Ngân Lượng nhận tiền thanh toán.
Ngân Lượng cung cấp môi trường thử nghiệm (sandbox) và môi trường thật. Hãy dùng tài khoản thử nghiệm khi bạn thử thanh toán, và dùng tài khoản người bán thật khi bạn chính thức vận hành.
Cấu hình cổng thanh toán
- Mở Hóa đơn ‣ Cấu hình ‣ Khoản thanh toán online ‣ Cổng thanh toán và mở Ngân Lượng. Hãy chắc rằng công ty ở đầu biểu mẫu là công ty bán hàng cho khách hàng của bạn.
- Trên tab Thông tin đăng nhập, nhập ID người bán Ngân Lượng (mã người bán), Mật khẩu người bán Ngân Lượng và Email người nhận Ngân Lượng.
- Chọn Trạng thái:
- Chế độ kiểm thử gửi thanh toán đến sandbox của Ngân Lượng. Không có khoản tiền nào bị thu.
- Đã bật gửi thanh toán đến trang Ngân Lượng thật. Chỉ dùng khi bạn đã nhập thông tin đăng nhập thật.
- Đã tắt ẩn Ngân Lượng khỏi khách hàng.
- Trên tab Cấu hình, nhấn Bật phương thức thanh toán nếu phương thức thanh toán Ngân Lượng chưa được kích hoạt, và quyết định có đánh dấu Chấp nhận thanh toán tạm giữ hay không (xem bên dưới).
- Dùng nút Đã hủy hiển thị ở đầu biểu mẫu để hiển thị cổng thanh toán trên website, để khách hàng nhìn thấy. Lưu biểu mẫu.
ID người bán và mật khẩu người bán chỉ quản trị viên nhìn thấy. Chúng không được sao chép khi bạn nhân bản cổng thanh toán, và bị xóa khi một bản sao cơ sở dữ liệu được chuẩn bị để thử nghiệm, nên bản sao thử nghiệm không bao giờ gửi thanh toán vào tài khoản thật của bạn.
Chấp nhận thanh toán tạm giữ
Với một số kiểu thanh toán, Ngân Lượng giữ tiền từ hai đến mười ngày trước khi chuyển cho bạn. Tùy chọn này quyết định cách Odoo xử lý một khoản thanh toán như vậy. Mặc định tùy chọn này tắt.
- Tắt: khoản thanh toán ở trạng thái Đang chờ, kèm thông báo rằng khoản tiền đang bị Ngân Lượng tạm giữ. Ngân Lượng không công bố thông báo nào khi giải ngân khoản tạm giữ, nên Odoo chỉ xác nhận khoản thanh toán nếu Ngân Lượng gửi thông báo lại. Hãy kiểm tra việc giải ngân trên cổng Ngân Lượng.
- Bật: Odoo xác nhận ngay khoản thanh toán, dù Ngân Lượng vẫn đang giữ tiền.
Chỉ bật tùy chọn này nếu bạn chấp nhận rủi ro Ngân Lượng có thể không giải ngân khoản tiền.
Gán quyền truy cập cho mọi người
Mở Thiết lập ‣ Người dùng & Công ty ‣ Người dùng, mở người dùng cần gán và đặt quyền truy cập theo bảng ở phần Tổng quan. Chỉ người dùng có quyền truy cập Quản trị / Cài đặt mới thay đổi được thông tin đăng nhập của cổng thanh toán.
Nhân viên công nợ phải thu: gửi đường dẫn thanh toán và theo dõi thanh toán
Gửi đường dẫn thanh toán trực tuyến
- Mở đơn bán hàng hoặc hóa đơn mà khách hàng cần thanh toán.
- Tạo đường dẫn thanh toán từ menu Tác vụ của chứng từ và gửi cho khách hàng.
- Khách hàng mở đường dẫn và chọn Ngân Lượng. Khách hàng cũng có thể thanh toán từ cổng thông tin khách hàng hoặc trang thanh toán của website mà không cần đường dẫn.
Theo dõi một khoản thanh toán
Odoo tự cập nhật khoản thanh toán. Bạn chỉ cần can thiệp khi một khoản thanh toán vẫn Đang chờ hoặc chuyển sang Lỗi.
- Bật chế độ nhà phát triển và mở Hóa đơn ‣ Cấu hình ‣ Khoản thanh toán online ‣ Giao dịch thanh toán.
- Mở khoản thanh toán và đọc thông báo của nó.
- Khoản thanh toán Đang chờ kèm thông báo đang bị Ngân Lượng tạm giữ là khoản tiền Ngân Lượng đang giữ. Trường Kiểu thanh toán Ngân Lượng cho biết Ngân Lượng giữ tiền bao nhiêu ngày. Hãy kiểm tra việc giải ngân trên cổng Ngân Lượng.
- Khoản thanh toán Lỗi nêu lý do Ngân Lượng từ chối, hoặc cho biết đơn, mã thông báo hay người nhận do Ngân Lượng báo về không khớp với khoản thanh toán của bạn. Hãy kiểm tra thông tin đăng nhập và email người nhận, rồi đề nghị khách hàng thanh toán lại.
Hoàn tiền một khoản thanh toán
Odoo không hoàn tiền các khoản thanh toán Ngân Lượng. Hãy đăng nhập cổng người bán của Ngân Lượng và hoàn tiền tại đó, rồi ghi nhận khoản hoàn tiền vào kế toán như với mọi khoản hoàn tiền khác.
Khách hàng: thanh toán trên trang của Ngân Lượng
- Chọn Ngân Lượng làm phương thức thanh toán khi thanh toán, hoặc trên trang mở từ đường dẫn thanh toán, và xác nhận thanh toán.
- Odoo mở trang thanh toán của Ngân Lượng. Chọn cách thanh toán: mã QR, thẻ ATM hoặc thẻ quốc tế. Trang hiển thị tiếng Việt nếu ngôn ngữ của bạn trong Odoo là tiếng Việt, ngược lại hiển thị tiếng Anh.
- Bạn có 24 giờ để thanh toán trên trang của Ngân Lượng.
- Sau khi thanh toán, Ngân Lượng đưa bạn quay lại cửa hàng, nơi bạn thấy trạng thái khoản thanh toán. Nếu đổi ý, hãy nhấn Hủy trên trang của Ngân Lượng: khoản thanh toán khi đó bị hủy.
Cách khoản thanh toán được xác nhận
Odoo không tin vào địa chỉ mà khách hàng được đưa về. Sau khi khách hàng quay lại, hủy, hoặc khi Ngân Lượng gửi thông báo, Odoo hỏi Ngân Lượng báo cáo giao dịch của đơn và làm theo câu trả lời đó. Odoo không tự hỏi Ngân Lượng: khoản thanh toán chỉ được cập nhật khi khách hàng quay lại hoặc khi Ngân Lượng gửi thông báo.
- Đường dẫn quay lại, hủy và thông báo mang một mã truy cập riêng. Đường dẫn không có mã hợp lệ, hoặc đường dẫn giả mạo, không làm thay đổi gì trong Odoo.
- Hủy: chỉ mã lỗi 115 do Ngân Lượng báo về mới làm hủy khoản thanh toán. Khoản thanh toán chưa được trả giữ nguyên trạng thái, và không bao giờ bị hủy chỉ vì quá cũ.
- Đối chiếu đơn: khoản thanh toán chỉ được xác nhận khi Ngân Lượng báo đúng mã đơn, đúng mã thông báo và đúng email người nhận của bạn.
Xử lý sự cố
| Sự cố | Cách xử lý |
|---|---|
| Ngân Lượng không hiển thị khi thanh toán | Kiểm tra cổng thanh toán đang Đã bật hoặc ở Chế độ kiểm thử, đã được hiển thị, phương thức thanh toán Ngân Lượng đã kích hoạt, quốc gia của khách hàng là Việt Nam và số tiền tính bằng VND. |
| Khoản thanh toán bị Lỗi ngay khi khách hàng chọn Ngân Lượng | Đọc thông báo: nó trích dẫn lỗi Ngân Lượng trả về. Kiểm tra ID người bán, mật khẩu người bán và email người nhận, và kiểm tra Chế độ kiểm thử có khớp với loại thông tin đăng nhập bạn đã nhập hay không. |
| Khách hàng đã trả tiền nhưng khoản thanh toán vẫn Đang chờ | Nhiều khả năng Ngân Lượng đang tạm giữ khoản thanh toán: hãy kiểm tra việc giải ngân trên cổng Ngân Lượng, hoặc đánh dấu Chấp nhận thanh toán tạm giữ nếu bạn chấp nhận rủi ro. Nếu Ngân Lượng báo khoản thanh toán đã trả, hãy bảo đảm địa chỉ website truy cập được để thông báo của Ngân Lượng đến được. |
| Khoản thanh toán bị Đã hủy | Khách hàng đã hủy trên trang của Ngân Lượng, hoặc Ngân Lượng báo đơn đã bị hủy. Đề nghị khách hàng thanh toán lại. |
| Bạn cần hoàn tiền cho khách hàng | Odoo không hoàn tiền được các khoản thanh toán Ngân Lượng. Hãy hoàn tiền cho khách hàng trong cổng người bán của Ngân Lượng. |
Câu hỏi thường gặp
- Tôi có thể nhận thanh toán cho chứng từ không tính bằng VND không?
- Có, nếu quản trị viên chọn như vậy. Đặt Tiền tệ quy đổi mặc định của cổng thanh toán là VND và thiết lập ứng dụng Quy đổi Tiền tệ cho Cổng Thanh toán. Khách hàng khi đó thanh toán số tiền đã quy đổi bằng VND.
- Vì sao khách hàng chỉ có 24 giờ?
- Đơn tạo trên Ngân Lượng có hiệu lực trong 24 giờ. Sau đó khách hàng phải bắt đầu một khoản thanh toán mới.
- Ai nhìn thấy mật khẩu người bán?
- Chỉ người dùng có quyền truy cập Quản trị / Cài đặt.
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.
