Trong trang này
Tích hợp WordPress / WooCommerce
Plugin TinoPay Gateway thêm phương thức thanh toán chuyển khoản bằng mã VietQR vào WooCommerce và tự xác nhận đơn hàng khi khách chuyển khoản — không cần lập trình. Khách quét QR, vài giây sau đơn hàng tự chuyển sang Đang xử lý.
Plugin dùng Webhooks của TinoPay ở phía sau, nhưng mọi cấu hình đều tự động — bạn không cần tự dựng endpoint.
#Luồng hoạt động
Khách đặt hàng trên WooCommerce
│
▼
Trang cảm ơn hiện mã VietQR (nội dung: DH<mã đơn>)
│ khách quét và chuyển khoản
▼
Ngân hàng báo có ──► TinoPay ghi nhận giao dịch, trích mã DH<mã đơn>
│
▼
Webhook gửi về website ──► Plugin khớp đơn, đổi trạng thái
- Chuyển đủ tiền: đơn chuyển sang trạng thái bạn chọn (mặc định Đang xử lý) và trừ tồn kho.
- Chuyển thiếu / thừa: đơn giữ nguyên trạng thái, plugin ghi chú số tiền thiếu/thừa để bạn xử lý.
- Trang thanh toán của khách tự hiện "Bạn đã thanh toán thành công" khi đơn được xác nhận.
#Yêu cầu
- WordPress 5.6+, PHP 7.2+, đã cài WooCommerce.
- Website chạy HTTPS (bắt buộc để nhận webhook và kết nối an toàn).
- Tài khoản TinoPay (đăng nhập bằng tài khoản Tino) và ít nhất một tài khoản ngân hàng đã kết nối. Hiện hỗ trợ tự xác nhận với BIDV — cần có tài khoản ảo (VA).
#Cài đặt
#Bước 1 — Tải và cài plugin
- Tải plugin TinoPay Gateway (.zip) — hoặc vào dashboard TinoPay → Tích hợp → WordPress → Tải plugin (.zip).
- Trong WordPress: Plugin → Cài mới → Tải plugin lên, chọn file zip vừa tải, bấm Cài đặt rồi Kích hoạt.
#Bước 2 — Kết nối với TinoPay
- Vào WooCommerce → Cài đặt → Thanh toán → TinoPay.
- Bấm Kết nối TinoPay — trình duyệt chuyển sang TinoPay.
- Đăng nhập bằng tài khoản Tino, kiểm tra tên website và bấm Cho phép kết nối.
Website chỉ được phép: xem thông tin tài khoản ngân hàng / VA, tạo webhook trỏ về chính website đó, xem và cập nhật cấu trúc mã thanh toán. Website không xem được mật khẩu và không chuyển được tiền.
#Bước 3 — Chọn tài khoản nhận tiền
- Chọn tài khoản ngân hàng. Với BIDV, chọn thêm tài khoản ảo (VA) — mã QR sẽ dùng số VA này.
- Bấm Hoàn tất thiết lập. Plugin tự:
- tạo webhook trên TinoPay (xem tại menu Tích hợp → Webhooks của TinoPay),
- đồng bộ cấu trúc mã thanh toán (mặc định tiền tố
DH, nội dung chuyển khoản dạngDH1234ứng với đơn #1234).
#Bước 4 — Đặt thử một đơn
Tạo một đơn hàng giá trị nhỏ, chọn phương thức TinoPay, quét QR và chuyển khoản. Sau vài giây đơn tự chuyển trạng thái và có ghi chú "TinoPay: Đã nhận thanh toán…".
#Tuỳ chọn trong plugin
| Tuỳ chọn | Ý nghĩa |
|---|---|
| Tiền tố mã thanh toán | Phải trùng với Cài đặt → Cấu trúc mã thanh toán trên TinoPay |
| Trạng thái đơn khi hoàn tất | Trạng thái gán cho đơn khi nhận đủ tiền (mặc định Đang xử lý) |
| Thông báo thành công | Nội dung hiển thị cho khách sau khi thanh toán |
| Chế độ tải xuống | Với sản phẩm số: hiện link tải ngay sau khi thanh toán |
| Hiển thị tên ngân hàng | Tên viết tắt, tên đầy đủ hoặc cả hai |
#Quản lý kết nối
Dashboard TinoPay → Tích hợp → WordPress, mục Website đã kết nối, liệt kê các website đã kết nối và thời điểm dùng gần nhất. Bấm Ngắt kết nối để thu hồi quyền ngay lập tức — website sẽ phải kết nối lại. Webhook đã tạo vẫn giữ nguyên, quản lý tại trang Webhooks.
#Cấu hình thủ công (không dùng Kết nối TinoPay)
Nếu không muốn kết nối OAuth, có thể cấu hình tay:
- Trong plugin, điền ngân hàng, số tài khoản (hoặc số VA), chủ tài khoản, tiền tố mã thanh toán và một API Key tự đặt (chỉ gồm chữ và số, tối thiểu 10 ký tự).
- Trên TinoPay → Tích hợp → Webhooks → Thêm webhook:
- URL:
https://<website-của-bạn>/wp-json/tinopay-gateway/v2/add-payment - Token: đúng API Key ở bước 1
- Sự kiện: Tiền vào, bật Bỏ qua nếu không có mã thanh toán
- URL:
- Trên TinoPay → Cài đặt → Cấu trúc mã thanh toán: thêm tiền tố trùng với plugin, độ dài hậu tố đủ chứa mã đơn hàng (VD 1–10, kiểu Chữ và số hoặc Chỉ số).
#Xử lý sự cố
| Hiện tượng | Nguyên nhân thường gặp |
|---|---|
| Khách chuyển khoản nhưng đơn không đổi trạng thái | Nội dung chuyển khoản thiếu/sai mã DH<mã đơn>; tiền tố plugin khác cấu trúc mã trên TinoPay; webhook đang tạm dừng |
Lịch sử webhook báo Invalid API Key |
Token của webhook trên TinoPay khác API Key trong plugin (cấu hình thủ công) |
Lịch sử webhook báo Order not found |
Mã trích được không khớp đơn nào — kiểm tra lại độ dài hậu tố trong cấu trúc mã thanh toán |
| Đơn ghi chú "thanh toán THIẾU/THỪA" | Khách chuyển sai số tiền — đơn giữ nguyên trạng thái để bạn xử lý |
| Bấm Kết nối TinoPay báo lỗi | Website chưa chạy HTTPS, hoặc phiên kết nối quá 15 phút — bấm lại |
| Không thấy mã QR ở trang cảm ơn | Chưa chọn tài khoản ngân hàng / VA trong cài đặt plugin |
Xem chi tiết từng lần gửi tại dashboard TinoPay → Tích hợp → Lịch sử webhook: mã HTTP, dữ liệu gửi đi và phản hồi của website.