Skip to Content

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

by
Odoo

$ 68.72

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 889
Technical Name pos_online_payment_qr_payos
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 889
Technical Name pos_online_payment_qr_payos
LicenseOPL-1
Websitehttps://duong-odoo-apps.odoo.com
Versions 17.0 18.0

Tích hợp thanh toán PayOS VietQR Trong Odoo POS

Video Demo

Tích hợp thanh toán QR PayOS cho điểm bán hàng Odoo

Module này tích hợp thanh toán QR PayOS vào điểm bán hàng (POS) của Odoo, cho phép khách hàng thanh toán bằng cách quét mã QR với ứng dụng ngân hàng hoặc ví điện tử.

Hệ thống tự động tạo mã QR cho từng đơn hàng và cập nhật trạng thái thanh toán theo thời gian thực thông qua webhook.

Tính năng chính

  • Tích hợp thanh toán QR PayOS vào điểm bán hàng Odoo
  • Tá»± động tạo mã QR cho từng đơn hàng
  • Tá»± động cập nhật trạng thái thanh toán qua webhook
  • Xác nhận thanh toán theo thời gian thá»±c
  • Hỗ trợ thanh toán không tiền mặt tại cá»­a hàng
  • TÆ°Æ¡ng thích với các ngân hàng tại Việt Nam
Thiết lập phương thức thanh toán PayOS VietQR trong pos Chọn phương thức thánh toán VietQR trong POS Quét QR VietQR Hoàn tất trên POS Đơn POS thanh toán tự động bởi PayOS

Quy trình thanh toán

Quy trình thanh toán QR PayOS 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 QR PayOS
  3. Hệ thống tự động tạo và hiển thị mã QR
  4. Khách hàng quét mã QR bằng ứng dụng ngân hàng/ví điện tử
  5. Thanh toán được xác nhận tự động qua webhook
  6. Đơn hàng được hoàn tất

Tính năng webhook

Module tích hợp webhook PayOS cho phép:

  • Xác thá»±c thanh toán tá»± động
  • Cập nhật trạng thái đơn hàng theo thời gian thá»±c
  • Xá»­ lý các trường hợp thanh toán thành công/thất bại
  • Đảm bảo an toàn với xác thá»±c chữ ký số
  • Tá»± động đăng ký webhook URL với PayOS

HỖ TRỢ KỸ THUẬT

Liên hệ hỗ trợ: duongodooapps@gmail.com

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

PayOS QR Payment for Point of Sale

PayOS QR Payment for Point of Sale

PayOS QR Payment Integration for Odoo Point of Sale

This module integrates PayOS QR payment into Odoo Point of Sale (POS), allowing customers to pay by scanning QR codes with banking apps or e-wallets.

The system automatically generates QR codes for each order and updates payment status in real-time through webhooks.

Key Features

  • Integration of PayOS QR payment into Odoo Point of Sale
  • Automatic QR code generation for each order
  • Automatic payment status updates via webhook
  • Real-time payment confirmation
  • Support for cashless payments in-store
  • Compatible with Vietnamese banks and e-wallets

Requirements

  • payment_payos module installed and configured
  • pos_online_payment module installed
  • PayOS account registered and activated

Configuration

  1. Go to Point of Sale > Configuration > Payment Methods
  2. Create a new payment method with type "Online Payment"
  3. Select the configured PayOS payment provider
  4. Enable the "Use QR Payment" option
  5. Register PayOS webhook to receive automatic payment status updates
  6. Save and use

Payment Process

The PayOS QR payment process at the point of sale:

  1. Staff creates an order on POS
  2. Selects PayOS QR payment method
  3. System automatically generates and displays QR code
  4. Customer scans QR code with banking app/e-wallet
  5. Payment is automatically confirmed via webhook
  6. Order is completed

Webhook Features

The module integrates PayOS webhooks allowing:

  • Automatic payment verification
  • Real-time order status updates
  • Handling of successful/failed payment cases
  • Security with digital signature verification
  • Automatic webhook URL registration with PayOS

TECHNICAL SUPPORT

Contact for support: duongodooapps@gmail.com

PayOS 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_payos trong Odoo để tích hợp thanh toán QR PayOS vào điểm bán hàng.

Để thiết lập tài khoản PayOS, bạn cần đăng ký tài khoản tại: PayOS: https://my.payos.vn/login

1. Tổng quan về module

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

  • Tạo mã QR thanh toán tự động cho từng đơn hàng POS
  • 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
  • Tương thích với hầu hết các ngân hàng tại Việt Nam

2. 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 payment_payos và cấu hình thông tin PayOS
  2. Đã cài đặt module pos_online_payment (được cài đặt tự động khi cài pos_online_payment_qr_payos)
  3. Có tài khoản PayOS đã được xác thực và kích hoạt

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

3.1. Cài đặt module

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

3.2. Cấu hình PayOS

Nếu bạn chưa cấu hình PayOS, hãy làm theo các bước sau, có thể tham khảo link của PayOS https://payos.vn/docs/huong-dan-su-dung/tao-tai-khoan-payos/:

  1. Đăng ký tài khoản PayOS tại https://my.payos.vn/login
Đăng ký tài khoản PayOS
  1. Sau khi đăng nhập, tạo kênh thanh toán và lấy thông tin: - Client ID - API Key - Checksum Key
  2. Trong Odoo, đi tới Website -> Cấu hình -> Phương thức thanh toán
  3. Kích hoạt cổng thanh toán PayOS và nhập thông tin từ bước 2
Cấu hình PayOS trong Odoo

3.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: PayOS QR Payment (hoặc tên tùy chọn) - Loại phương thức: Online Payment - Nhà cung cấp thanh toán: PayOS - Sử dụng thanh toán QR: Bật - Tự động xác nhận đơn hàng: Bật (tùy chọn)
Cấu hình phương thức thanh toán POS

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

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

3.4. Cấu hình Webhook

Để nhận thông báo thanh toán tự động từ PayOS:

  1. Trong cấu hình PayOS, bạn sẽ thấy URL webhook được tạo tự động
  2. Nhấn nút Đăng ký Webhook PayOS để đăng ký webhook với PayOS
  3. Webhook sẽ giúp cập nhật trạng thái thanh toán tự động khi khách hàng hoàn tất giao dịch
Cấu hình webhook PayOS

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

4.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 PayOS QR
  3. Hệ thống tự động tạo và hiển thị mã QR
  4. Khách hàng quét mã QR bằng ứng dụng ngân hàng/ví điện tử
  5. Sau khi thanh toán thành công: - PayOS 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

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

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

  1. Mã QR thanh toán
  2. Số tiền cần thanh toán
  3. Mã đơn
Màn hình thanh toán QR POS

4.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ết hạn: Mã QR đã hết hạn, cần tạo mã mới
  4. Lỗi: Có lỗi xảy ra trong quá trình thanh toán

Nếu webhook được cấu hình đúng, trạng thái thanh toán sẽ được cập nhật tự động trong thời gian thực.

5. Quản lý giao dịch

5.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 "PayOS QR"
  3. Mở đơn hàng để xem chi tiết giao dịch
Lịch sử đơn hàng POS

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

6.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 PayOS - Kiểm tra log lỗi trong Odoo - Làm mới mã QR

6.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 - Đảm bảo URL webhook có thể truy cập từ internet - Kiểm tra xem webhook đã được đăng ký thành công với PayOS chưa - Kiểm tra log lỗi trong Odoo

6.3. Lỗi thanh toán

Vấn đề: Khách hàng không thể thanh toán

Giải pháp: - Kiểm tra kết nối internet của khách hàng - Đảm bảo mã QR được hiển thị đúng - Kiểm tra xem tài khoản PayOS có đang hoạt động không - Kiểm tra giới hạn giao dịch của PayOS

7. Hỗ trợ bổ sung

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

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

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

  • Giữ thông tin xác thực API 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ụ và hướng dẫn nội dung của PayOS

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

PayOS QR Payment for Point of Sale Usage Guide

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

To set up your PayOS account, you need to register at: PayOS: https://my.payos.vn/login

1. Module Overview

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

  • Automatically generate payment QR codes for each POS order
  • Receive payment notifications through webhooks
  • Confirm payments in real-time
  • Automatically complete orders when payment is successful
  • Compatible with most banks in Vietnam

2. Prerequisites

Before installing this module, you need:

  1. The payment_payos module installed and configured with PayOS information
  2. The pos_online_payment module installed (automatically installed when installing pos_online_payment_qr_payos)
  3. A verified and activated PayOS account

3. Installation and Configuration

3.1. Install Module

  1. Install the pos_online_payment_qr_payos module
  2. Ensure that the dependent modules are installed: - payment_payos - pos_online_payment

3.2. Configure PayOS

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

  1. Register a PayOS account at https://my.payos.vn/login
  2. After logging in, create a payment channel and obtain: - Client ID - API Key - Checksum Key
  3. In Odoo, go to Website -> Configuration -> Payment Methods
  4. Activate the PayOS payment gateway and enter the information from step 2

3.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: PayOS QR Payment (or a name of your choice) - Method Type: Online Payment - Payment Provider: PayOS - Use QR Payment: Enabled - Automatically validate order: Enabled (optional)
  4. Go to Point of Sale -> Configuration -> Point of Sale
  5. Select the point of sale to configure
  6. In the Payment Methods tab, add the PayOS QR payment method you created

3.4. Configure Webhook

To receive automatic payment notifications from PayOS:

  1. In the PayOS configuration, you will see the automatically generated webhook URL
  2. Click the Register PayOS Webhook button to register the webhook with PayOS
  3. The webhook will help update payment status automatically when customers complete transactions

4. Using in Point of Sale

4.1. Payment Process

When customers pay at the point of sale:

  1. Staff creates an order on POS
  2. Selects the PayOS QR payment method
  3. The system automatically generates and displays the QR code
  4. Customer scans the QR code with a banking app/e-wallet
  5. After successful payment: - PayOS sends notification via webhook - Payment status is updated on the POS screen - The order is automatically completed

4.2. QR Payment Screen

When selecting the PayOS QR payment method, the screen will display:

  1. Payment QR code
  2. Amount to be paid
  3. Remaining time for payment
  4. Payment status (Waiting, Paid, Expired)
  5. Button to refresh the QR code if needed

4.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. Expired: QR code has expired, need to create a new one
  4. Error: An error occurred during the payment process

If the webhook is configured correctly, the payment status will be updated automatically in real-time.

5. Transaction Management

5.1. View Transaction History

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

5.2. Reconcile Transactions

To reconcile transactions between Odoo and PayOS:

  1. Go to Accounting -> Customers -> Payments
  2. Filter by payment method "PayOS"
  3. Compare with transaction reports from PayOS

6. Troubleshooting

6.1. QR Display Errors

Issue: QR code does not display or displays with errors

Solution: - Check internet connection - Check PayOS configuration - Check error logs in Odoo - Refresh the QR code

6.2. Webhook Errors

Issue: Payment status is not updated automatically

Solution: - Check webhook configuration - Ensure webhook URL is accessible from the internet - Check if the webhook has been successfully registered with PayOS - Check error logs in Odoo

6.3. Payment Errors

Issue: Customers cannot pay

Solution: - Check customer's internet connection - Ensure QR code is displayed correctly - Check if PayOS account is active - Check PayOS transaction limits

7. Additional Support

For additional support:

  • Email: duongodooapps@gmail.com
  • Refer to PayOS API documentation: https://payos.vn/docs
  • Contact PayOS technical support: https://payos.vn/contact

8. Security Notes

  • Keep API credentials secure
  • Regularly review app permissions
  • Monitor API usage limits
  • Comply with PayOS terms of service and content guidelines
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.