Tích hợp Pay2S vào WooCommerce

Nội dung Markdown đầy đủ của trang tài liệu.

# 🧾 Tích hợp Pay2S vào WooCommerce

Tài liệu này hướng dẫn chi tiết cách cài đặt và cấu hình plugin **Pay2S for WooCommerce** để tích hợp thanh toán tự động cho website WordPress sử dụng WooCommerce.

## ⚙️ Yêu cầu hệ thống

- PHP 7.2 trở lên
- WordPress 5.7 trở lên
- WooCommerce 5.2 trở lên

## 🌐 Trình duyệt hỗ trợ

- Google Chrome
- Safari
- Microsoft Edge
- Firefox

## Cài đặt

:::: tip Pay2S for WooCommerce
Pay2S for WooCommerce là plugins hỗ trợ tích hợp thanh toán tự động trên hệ thống Pay2S. Trước khi tiếp tục, hãy tạo tài khoản trên Pay2S.
::::

## 🚀 Cài đặt Plugin

### 🔧 Cài đặt thủ công
- Tải gói Pay2S Gateway 1.3.10 ở mục bên dưới.
- Giải nén vào thư mục `/wp-content/plugins`.
- Thư mục sau khi giải nén: `/wp-content/plugins/pay2s-gateway`.

## Tải về

Gói hiện có: **Pay2S Gateway 1.3.10**. Hỗ trợ thanh toán tại website, truy vấn trạng thái bổ sung cho IPN và tải QR.

<a href="/downloads/integrations/pay2s-gateway-1.3.10.zip" class="custom-button">
<span>&#x1F4E9;</span> Pay2S for Woocommerce
</a>

## ✅ Sau khi cài đặt

- Truy cập `WooCommerce > Cài đặt > Thanh toán > Pay2S`.
- Nhập đầy đủ thông tin gồm: Partner Code, Access Key, Secret Key, Bank Account,...

## Video hướng dẫn

## Thiết lập cá nhân
![Setting](/assets/thiet-lap-plugin.png)

Các tham số cơ bản cho plugins:

````
- Tiêu đề
- Mô tả
- Nội dung thanh toán
- Trạng thái đơn hàng khi đơn hàng được tạo
- Trạng thái đơn hàng khi thanh toán thành công
- Trạng thái đơn hàng khi thanh toán thất bại
- Thông báo khi thanh toán thành công
- Nút thanh toán
- Tài khoản ngân hàng
- Partner Code
- Access Key
- Secret Key
- API Endpoint
````
:::: info Tiêu đề
Thiết lập tên hiển thị tên cổng thanh toán.
::::

:::: info Mô tả
Đây là thiết lập hiển thị mô tả nằm bên dưới tên cổng thanh toán khi người dùng chọn cổng thanh toán
::::

:::: info Nội dung thanh toán (Ký tự định danh)
Đây là ký tự giúp phân biệt được loại giao dịch mà bạn muốn plugins xác minh và xử lý giao dịch cho bạn.
::::

:::: info Trạng thái đơn hàng khi đơn hàng được tạo

Trạng thái khi đơn hàng vừa được khởi tạo chưa thanh toán (Ví dụ Pending)
::::
:::: info Trạng thái đơn hàng khi thanh toán thành công

Trạng thái khi đơn hàng khi được thanh toán thành công.
::::
:::: info Trạng thái đơn hàng khi thanh toán thất bại

Trạng thái khi đơn hàng khi được thanh toán thất bại.
::::
:::: info Thông báo khi thanh toán thành công

Thông báo tại trang chủ khi thanh toán thành công.
::::
:::: info Nút thanh toán

Nút hiển thị để khách hàng bấm thanh toán.
::::
:::: info Tài khoản ngân hàng
Điền số tài khoản và BankCode (Tham khảo BankCode tại [Danh sách ngân hàng hỗ trợ](https://docs.pay2s.vn/api/bankcode.html).)

Ví dụ: `ACB`, `BIDV`, `MBB`, `VCB`,....

![Tài khoản ngân hàng](/assets/tai-khoan-ngan-hang-woo.png)
::::

:::: info Partner Code

Đây là mã giúp xác minh tài khoản tại Pay2S. Mã này được sinh ra khi đăng ký tài khoản thành công. Xem tại [Tích hợp Web/App](https://my.pay2s.vn/payment-intergration-center).
::::
:::: info Access Key

Đây là API khởi tạo giao dịch tại Pay2S. Xem tại [Tích hợp Web/App](https://my.pay2s.vn/payment-intergration-center).
::::

## ♻️ Nâng cấp

Pay2S for WooCommerce tương thích với phiên bản mới nhất của WooCommerce (5.2+). Việc nâng cấp plugins đơn giản chỉ là ghi đè bộ mã nguồn tải về. Nếu có bất kỳ lưu ý nào về việc nâng cấp, hãy tham khảo hướng dẫn nâng cấp.

## ❓ Câu hỏi thường gặp (FAQ)

### Q: Tôi không thấy phương thức thanh toán Pay2S xuất hiện?
- Đảm bảo plugin đã được kích hoạt.
- Kiểm tra trong mục `WooCommerce > Cài đặt > Thanh toán`.
- Kiểm tra giao diện (Theme) hiện tại có chiếm trang thanh toán của `WooCommerce` hay không.

### Q: Tôi không biết BankCode là gì?
- Vui lòng xem tại [Danh sách ngân hàng hỗ trợ](https://docs.pay2s.vn/api/bankcode.html).