Skip to Content

Tích hợp thanh toán ZaloPay Trong Odoo POS - POS Online Payment QR - ZaloPay

by
Odoo

$ 93.40

v 18.0 Third Party
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Community Apps Dependencies
Lines of code 1298
Technical Name pos_online_payment_qr_zalopay
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies • Point of Sale (point_of_sale)
• Invoicing (account)
• Discuss (mail)
• Inventory (stock)
Community Apps Dependencies
Lines of code 1298
Technical Name pos_online_payment_qr_zalopay
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0

Tích hợp thanh toán ZaloPay QR cho Điểm Bán Hàng

Module này tích hợp thanh toán QR ZaloPay vào hệ thống Điểm Bán Hàng Odoo, cho phép doanh nghiệp chấp nhận thanh toán QR thông qua cổng thanh toán ZaloPay với tính năng hoàn tất đơn hàng tự động.

ZaloPay QR chỉ hỗ trợ phương thức thanh toán VietQR và ZaloPay Wallet. Các phương thức khác như Card hoặc NAPAS Card không được hỗ trợ.

Video Demo

Cấu hình phương thức thanh toán POS

Hướng dẫn thiết lập phương thức thanh toán ZaloPay QR trong POS:

  • Vào Điểm bán hàng > Cấu hình > PhÆ°Æ¡ng thức thanh toán
  • Tạo phÆ°Æ¡ng thức thanh toán mới với loại "Online Payment"
  • Chọn nhà cung cấp ZaloPay và phÆ°Æ¡ng thức VietQR hoặc ZaloPay Wallet
  • Thêm vào cấu hình điểm bán hàng
Cấu hình phương thức thanh toán POS

Giao diện thanh toán QR

Màn hình thanh toán QR ZaloPay trên POS hiển thị:

  • Mã QR thanh toán ZaloPay tá»± động tạo
  • Thông tin đơn hàng và số tiền
  • Hướng dẫn thanh toán cho khách hàng
  • Trạng thái thanh toán cập nhật real-time
Giao diện thanh toán QR trên POS

Hướng dẫn sử dụng

Vui lòng ghé vào tab Documentation bên phải tab này để xem hướng dẫn sử dụng

Documentation Tab

Hỗ trợ

Email: duongodooapps@gmail.com

Website: https://duong-odoo-apps.odoo.com

Tài liệu ZaloPay: https://docs.zalopay.vn/

ZaloPay QR Payment for Point of Sale

English version / Phiên bản tiếng Anh

ZaloPay QR Payment for POS

ZaloPay QR Payment Integration for Point of Sale

This module integrates ZaloPay QR payment into the Odoo Point of Sale system, enabling businesses to accept QR-based payments through ZaloPay gateway with automatic order completion.

Important Note:

ZaloPay QR only supports VietQR and ZaloPay Wallet payment methods. Other methods like Card or NAPAS Card are not supported.

Video Demo

POS Payment Method Configuration

Guide to set up ZaloPay QR payment method in POS:

  • Go to Point of Sale > Configuration > Payment Methods
  • Create new payment method with type "Online Payment"
  • Select ZaloPay provider and choose VietQR or ZaloPay Wallet method
  • Add to point of sale configuration
POS Payment Method Configuration

QR Payment Interface

ZaloPay QR payment screen on POS displays:

  • Auto-generated ZaloPay QR code
  • Order information and amount
  • Payment instructions for customers
  • Real-time payment status updates
QR Payment Interface on POS

Installation & Configuration

  1. Install the module pos_online_payment_qr_zalopay
  2. Configure ZaloPay payment provider with your merchant credentials
  3. Create POS payment method with type "Online Payment"
  4. Select ZaloPay provider and choose VietQR or ZaloPay Wallet
  5. Add to POS configuration in Point of Sale settings

Support

Email: duongodooapps@gmail.com

Website: https://duong-odoo-apps.odoo.com

ZaloPay Documentation: https://docs.zalopay.vn/

ZaloPay QR Payment for Point of Sale Usage Guide

Hướng dẫn này sẽ giúp bạn thiết lập và sử dụng module pos_online_payment_qr_zalopay trong Odoo để tích hợp thanh toán QR ZaloPay vào điểm bán hàng.

Để thiết lập tài khoản ZaloPay, bạn cần đăng ký tài khoản merchant tại: ZaloPay Merchant: https://merchant.zalopay.vn/

1. Tổng quan về module

Module pos_online_payment_qr_zalopay tích hợp thanh toán QR ZaloPay vào điểm bán hàng (POS) của Odoo, cho phép bạn:

  • Tạo mã QR thanh toán ZaloPay tự động cho từng đơn hàng POS
  • Hỗ trợ 2 phương thức thanh toán: VietQR và ZaloPay Wallet
  • Nhận thông báo thanh toán thông qua webhook
  • Xác nhận thanh toán theo thời gian thực
  • Hoàn tất đơn hàng tự động khi thanh toán thành công

2. Phương thức thanh toán được hỗ trợ

ZaloPay QR chỉ hỗ trợ 2 phương thức thanh toán:

VietQR - Thanh toán qua QR ngân hàng - Khách hàng quét mã QR bằng app ngân hàng - Chuyển khoản trực tiếp từ tài khoản ngân hàng

ZaloPay Wallet - Thanh toán qua ví ZaloPay - Khách hàng quét mã QR bằng app ZaloPay - Thanh toán từ số dư ví ZaloPay

3. Yêu cầu trước khi cài đặt

Trước khi cài đặt module này, bạn cần:

  1. Đã cài đặt module d_payment_zalopay và cấu hình thông tin ZaloPay
  2. Đã cài đặt module d_pos_online_payment_qr (được cài đặt tự động)
  3. Có tài khoản ZaloPay Merchant đã được xác thực và kích hoạt

4. Cài đặt và Cấu hình

4.1. Cài đặt module

  1. Cài đặt module pos_online_payment_qr_zalopay
  2. Đảm bảo rằng các module phụ thuộc đã được cài đặt: - d_payment_zalopay - d_pos_online_payment_qr

4.2. Cấu hình ZaloPay

Nếu bạn chưa cấu hình ZaloPay, hãy làm theo các bước sau:

  1. Đăng ký tài khoản ZaloPay Merchant tại https://merchant.zalopay.vn/
  2. Sau khi đăng nhập, lấy thông tin: - App ID - Key1 (cho MAC calculation) - Key2 (cho callback verification)
  3. Trong Odoo, đi tới Cấu hình -> Các nhà cung cấp thanh toán
  4. Kích hoạt cổng thanh toán ZaloPay và nhập thông tin từ bước 2

4.3. Cấu hình phương thức thanh toán POS

  1. Đi tới Điểm bán hàng -> Cấu hình -> Phương thức thanh toán
  2. Tạo phương thức thanh toán mới
  3. Cấu hình như sau: - Tên: ZaloPay QR Payment (hoặc tên tùy chọn) - Loại: Chọn "Online Payment" - Bật thanh toán QR: Tích chọn - Nhà cung cấp thanh toán: Chọn ZaloPay - Phương thức thanh toán: Chọn VietQR hoặc ZaloPay Wallet
Cấu hình phương thức thanh toán POS

Important

ZaloPay QR chỉ hỗ trợ 2 phương thức: VietQR và ZaloPay Wallet. Nếu bạn chọn phương thức khác, hệ thống sẽ báo lỗi.

Chi tiết cấu hình:

  • VietQR: Thanh toán qua QR ngân hàng, khách hàng quét bằng app ngân hàng
  • ZaloPay Wallet: Thanh toán qua ví ZaloPay, khách hàng quét bằng app ZaloPay

4. Cấu hình điểm bán hàng

  1. Đi tới Điểm bán hàng -> Cấu hình -> Cài đặt
  2. Chọn điểm bán hàng cần cấu hình
  3. Trong tab Phương thức thanh toán, thêm phương thức thanh toán ZaloPay QR đã tạo
Cấu hình phương thức thanh toán trong điểm bán hàng

5. Sử dụng trong điểm bán hàng

5.1. Quy trình thanh toán

Khi khách hàng thanh toán tại điểm bán hàng:

  1. Nhân viên tạo đơn hàng trên POS
  2. Chọn phương thức thanh toán ZaloPay QR
  3. Hệ thống tự động tạo và hiển thị mã QR ZaloPay
  4. Khách hàng quét mã QR bằng: - App ZaloPay
  5. Sau khi thanh toán thành công: - ZaloPay gửi thông báo qua webhook - Trạng thái thanh toán được cập nhật trên màn hình POS - Đơn hàng được hoàn tất tự động

5.2. Màn hình thanh toán QR

Khi chọn phương thức thanh toán ZaloPay QR, màn hình POS sẽ hiển thị:

  1. Mã QR thanh toán ZaloPay - Tự động tạo cho từng đơn hàng
  2. Số tiền cần thanh toán - Hiển thị rõ ràng
  3. Thông tin đơn hàng - Mã đơn hàng, thời gian tạo
  4. Hướng dẫn thanh toán - Hướng dẫn khách hàng cách quét QR
  5. Trạng thái thanh toán - Cập nhật real-time
Giao diện thanh toán QR trên POS

Quy trình hiển thị QR:

  1. Nhân viên chọn phương thức thanh toán ZaloPay QR
  2. Hệ thống gọi API ZaloPay để tạo mã QR
  3. Mã QR hiển thị trên màn hình POS
  4. Khách hàng quét mã QR bằng app tương ứng
  5. Trạng thái thanh toán được cập nhật tự động

5.3. Xử lý trạng thái thanh toán

Hệ thống tự động xử lý các trạng thái thanh toán:

  1. Đang chờ: Khách hàng chưa thanh toán
  2. Đã thanh toán: Thanh toán thành công, đơn hàng được hoàn tất
  3. Hủy bỏ: Khách hàng hủy thanh toán
  4. Hết hạn: Mã QR đã hết hạn, cần tạo mã mới
  5. Lỗi: Có lỗi xảy ra trong quá trình thanh toán

6. Quản lý giao dịch

6.1. Xem lịch sử giao dịch

  1. Đi tới Điểm bán hàng -> Đơn hàng
  2. Lọc theo phương thức thanh toán "ZaloPay QR"
  3. Mở đơn hàng để xem chi tiết giao dịch ZaloPay

6.2. Thông tin giao dịch ZaloPay

Trong chi tiết giao dịch, bạn có thể xem: - ZaloPay Transaction ID - Mã QR đã sử dụng - Phí giao dịch (nếu có) - Số tiền giảm giá (nếu có) - Thông tin kênh thanh toán

7. Xử lý lỗi và khắc phục sự cố

7.1. Lỗi hiển thị mã QR

Vấn đề: Mã QR không hiển thị hoặc hiển thị lỗi

Giải pháp: - Kiểm tra kết nối internet - Kiểm tra cấu hình ZaloPay - Kiểm tra xem phương thức thanh toán có được hỗ trợ không (VietQR hoặc ZaloPay Wallet) - Kiểm tra log lỗi trong Odoo

7.2. Lỗi webhook

Vấn đề: Trạng thái thanh toán không được cập nhật tự động

Giải pháp: - Kiểm tra cấu hình webhook trong ZaloPay - Đảm bảo URL webhook có thể truy cập từ internet - Kiểm tra log lỗi trong Odoo - Kiểm tra xem callback URL có đúng định dạng không

7.3. Lỗi phương thức thanh toán không hỗ trợ

Vấn đề: Hệ thống báo lỗi phương thức thanh toán không được hỗ trợ

Giải pháp: - Chỉ chọn phương thức VietQR hoặc ZaloPay Wallet - Không chọn các phương thức khác như Card, NAPAS Card

8. Hỗ trợ bổ sung

Để được hỗ trợ thêm:

  • Email: duongodooapps@gmail.com
  • Tham khảo tài liệu API của ZaloPay: https://docs.zalopay.vn/
  • Liên hệ hỗ trợ kỹ thuật của ZaloPay

9. Lưu ý về bảo mật

  • Giữ thông tin xác thực API (App ID, Key1, Key2) an toàn
  • Thường xuyên kiểm tra quyền ứng dụng
  • Giám sát giới hạn sử dụng API
  • Tuân thủ điều khoản dịch vụ của ZaloPay

10. Phiên bản tiếng Anh (English Version)

ZaloPay QR Payment for Point of Sale Usage Guide

This guide will help you set up and use the pos_online_payment_qr_zalopay module in Odoo to integrate ZaloPay QR payment into the point of sale.

To set up your ZaloPay account, you need to register at: ZaloPay Merchant: https://merchant.zalopay.vn/

1. Module Overview

The pos_online_payment_qr_zalopay module integrates ZaloPay QR payment into the Odoo Point of Sale (POS), allowing you to:

  • Automatically generate ZaloPay QR codes for each POS order
  • Support 2 payment methods: VietQR and ZaloPay Wallet
  • Receive payment notifications through webhooks
  • Confirm payments in real-time
  • Automatically complete orders when payment is successful

2. Supported Payment Methods

ZaloPay QR only supports 2 payment methods:

VietQR - Payment via bank QR code - Customers scan QR code with banking app - Direct transfer from bank account

ZaloPay Wallet - Payment via ZaloPay wallet - Customers scan QR code with ZaloPay app - Payment from ZaloPay wallet balance

3. Prerequisites

Before installing this module, you need:

  1. The d_payment_zalopay module installed and configured with ZaloPay information
  2. The d_pos_online_payment_qr module installed (automatically installed)
  3. A verified and activated ZaloPay Merchant account

4. Installation and Configuration

4.1. Install Module

  1. Install the pos_online_payment_qr_zalopay module
  2. Ensure that the dependent modules are installed: - d_payment_zalopay - d_pos_online_payment_qr

4.2. Configure ZaloPay

If you haven't configured ZaloPay yet, follow these steps:

  1. Register a ZaloPay Merchant account at https://merchant.zalopay.vn/
  2. After logging in, obtain the information: - App ID - Key1 (for MAC calculation) - Key2 (for callback verification)
  3. In Odoo, go to Website -> Configuration -> Payment Methods
  4. Activate the ZaloPay payment gateway and enter the information from step 2

4.3. Configure POS Payment Method

  1. Go to Point of Sale -> Configuration -> Payment Methods
  2. Create a new payment method
  3. Configure as follows: - Name: ZaloPay QR Payment (or a name of your choice) - Type: Select "Online Payment" - Enable QR Payment: Check - Payment Provider: Select ZaloPay - Payment Method: Select VietQR or ZaloPay Wallet
POS Payment Method Configuration

Important

ZaloPay QR only supports 2 methods: VietQR and ZaloPay Wallet. If you select other methods, the system will show an error.

Configuration Details:

  • VietQR: Payment via bank QR, customers scan with banking app
  • ZaloPay Wallet: Payment via ZaloPay wallet, customers scan with ZaloPay app

4. Configure Point of Sale

  1. Go to Point of Sale -> Configuration -> Point of Sale
  2. Select the point of sale to configure
  3. In the Payment Methods tab, add the ZaloPay QR payment method you created
Configure payment methods in point of sale

5. Using in Point of Sale

5.1. Payment Process

When customers pay at the point of sale:

  1. Staff creates an order on POS
  2. Selects the ZaloPay QR payment method
  3. The system automatically generates and displays the ZaloPay QR code
  4. Customer scans the QR code with: - Banking app (if VietQR is selected) - ZaloPay app (if ZaloPay Wallet is selected)
  5. After successful payment: - ZaloPay sends notification via webhook - Payment status is updated on the POS screen - The order is automatically completed

5.2. QR Payment Screen

When selecting the ZaloPay QR payment method, the POS screen will display:

  1. ZaloPay payment QR code - Automatically generated for each order
  2. Amount to be paid - Clearly displayed
  3. Order information - Order code, creation time
  4. Payment instructions - Guide customers on how to scan QR
  5. Payment status - Real-time updates
QR Payment Interface on POS

QR Display Process:

  1. Staff selects ZaloPay QR payment method
  2. System calls ZaloPay API to generate QR code
  3. QR code is displayed on POS screen
  4. Customer scans QR code with corresponding app
  5. Payment status is automatically updated

5.3. Payment Status Handling

The system automatically handles payment statuses:

  1. Waiting: Customer has not yet paid
  2. Paid: Payment successful, order is completed
  3. Cancelled: Customer cancelled payment
  4. Expired: QR code has expired, need to create a new one
  5. Error: An error occurred during the payment process

6. Transaction Management

6.1. View Transaction History

  1. Go to Point of Sale -> Orders
  2. Filter by payment method "ZaloPay QR"
  3. Open an order to view ZaloPay transaction details

6.2. ZaloPay Transaction Information

In the transaction details, you can view: - ZaloPay Transaction ID - QR code used - Transaction fees (if any) - Discount amount (if any) - Payment channel information

7. Troubleshooting

7.1. QR Display Errors

Issue: QR code does not display or displays with errors

Solution: - Check internet connection - Check ZaloPay configuration - Check if payment method is supported (VietQR or ZaloPay Wallet) - Check error logs in Odoo

7.2. Webhook Errors

Issue: Payment status is not updated automatically

Solution: - Check webhook configuration in ZaloPay - Ensure webhook URL is accessible from the internet - Check error logs in Odoo - Check if callback URL has correct format

7.3. Unsupported Payment Method Error

Issue: System shows error that payment method is not supported

Solution: - Only select VietQR or ZaloPay Wallet methods - Do not select other methods like Card, NAPAS Card

8. Additional Support

For additional support:

  • Email: duongodooapps@gmail.com
  • Refer to ZaloPay API documentation: https://docs.zalopay.vn/
  • Contact ZaloPay technical support

9. Security Notes

  • Keep API credentials (App ID, Key1, Key2) secure
  • Regularly review app permissions
  • Monitor API usage limits
  • Comply with ZaloPay terms of service
Odoo Proprietary License v1.0

This software and associated files (the "Software") may only be used (executed,
modified, executed after modifications) if you have purchased a valid license
from the authors, typically via Odoo Apps, or if you have received a written
agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically
by depending on it, importing it and using its resources), but without copying
any source code or material from the Software. You may distribute those
modules under the license of your choice, provided that this license is
compatible with the terms of the Odoo Proprietary License (For example:
LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software
or modified copies of the Software.

The above copyright notice and this permission notice must be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.