Kết nối WooCommerce dùng plugin dongtien-pay cài trên WordPress. Plugin tạo một yêu cầu thanh toán có mã VietQR cho mỗi đơn, và khi giao dịch đã xác thực khớp với đơn, cửa hàng nhận sự kiện đã thanh toán để đổi trạng thái đơn. Tiền chuyển thẳng vào tài khoản ngân hàng của cửa hàng.
Luồng thanh toán
- Khách đặt hàng và chọn chuyển khoản.
- Plugin tạo yêu cầu thanh toán qua API, gắn với đơn bằng mã tham chiếu
wc_<mã đơn>. - Khách quét mã VietQR có nội dung
DTPcộng 6 ký tự và chuyển khoản. - Biến động số dư về Dòng Tiền Pro và được xác thực.
- Dòng Tiền Pro gửi sự kiện đã thanh toán tới cửa hàng, ký theo Standard Webhooks; plugin kiểm chữ ký rồi cập nhật đơn.
“Đã xác thực”: xác thực nguồn, không phải ngân hàng xác nhận quyết toán.
Cài đặt
- Mở màn Tích hợp, chọn WooCommerce và tạo kết nối.
- Cài plugin dongtien-pay trên WordPress và nhập mã kết nối.
- Lưu khoá ký được cấp một lần khi kết nối; plugin dùng khoá này để kiểm chữ ký sự kiện.
- Gửi thử: cửa hàng nhận một sự kiện
test.pingcó chữ ký. - Đặt một đơn thử với số tiền nhỏ và xem đơn đổi trạng thái.
Webhook đơn hàng của WooCommerce
Nếu bạn muốn Dòng Tiền Pro nhận cả webhook đơn hàng gốc của WooCommerce, cần thêm khoá REST API của WooCommerce. Hệ thống chỉ nhận webhook có chữ ký đúng và luôn đọc lại đơn từ REST API của cửa hàng; nội dung webhook không bao giờ được tin trực tiếp. Thiếu khoá REST thì webhook đơn hàng bị từ chối.
Điều kết nối này không làm
- Không có ví và không giữ tiền của cửa hàng hay của khách.
- Không đổi trạng thái đơn khi giao dịch mới tạm tính.
- Không gửi tin báo biến động số dư vào WordPress; dùng Telegram, Lark, Slack hoặc Discord cho việc đó.
Câu hỏi thường gặp
Khách chuyển khoản không quét mã thì đơn có cập nhật không?
Không tự động. Giao dịch vẫn vào sổ; người có quyền gắn với đơn đúng.
Plugin có cần mở cổng nào trên máy chủ không?
Cửa hàng cần nhận được yêu cầu HTTPS tới đường dẫn REST của plugin trên WordPress.
Mỗi đơn có tính phí riêng không?
Phí tính theo giao dịch đã xác thực sau gộp trùng. Xem bảng giá.
