Nối WooCommerce, Haravan, Shopify với VietQR

Khi nối cửa hàng, mỗi đơn hàng mới tạo một yêu cầu thanh toán VietQR kèm mã DTP; khi giao dịch tương ứng được xác thực, Dòng Tiền Pro đánh dấu đơn là đã thanh toán trên cửa hàng. Nhãn Đã xác thực là xác thực nguồn, không phải ngân hàng xác nhận quyết toán. Đơn không bao giờ được đánh dấu đã thanh toán chỉ vì một tin SMS hay giao dịch tạm tính.

flowchart LR
  A["Khách đặt đơn"] --> B["Dòng Tiền Pro tạo yêu cầu và mã DTP"]
  B --> C["Khách quét VietQR"]
  C --> D["Giao dịch đã xác thực về"]
  D --> E["Đánh dấu đơn đã thanh toán"]

WooCommerce

Dòng Tiền Pro cung cấp plugin WordPress dongtien-pay cho WooCommerce. Plugin hiện mã QR và trạng thái thanh toán theo thời gian thực ở trang thanh toán và hỗ trợ Checkout Blocks và HPOS.

1. Cài và bật plugin dongtien-pay trong WordPress.

2. Trong cài đặt plugin bấm Kết nối. Trình duyệt chuyển sang Dòng Tiền Pro để bạn đăng nhập và đồng ý, rồi quay lại. Bạn cũng có thể dán khoá API dt_live_… có quyền tạo yêu cầu thanh toán.

3. Chọn tài khoản ngân hàng nhận tiền.

4. Đặt một đơn thử, quét QR bằng một khoản nhỏ và xem đơn chuyển sang đã thanh toán.

Xem thêm hướng dẫn chi tiết tại Tích hợp WooCommerce.

Haravan và Shopify

Haravan và Shopify nối bằng ứng dụng cấp quyền qua OAuth. Bạn cài ứng dụng vào cửa hàng, đồng ý quyền, rồi chọn tài khoản ngân hàng nhận tiền ở màn Tích hợp. Dòng Tiền Pro đăng ký các webhook cần thiết với cửa hàng.

Cách hiển thị mã chuyển khoản và QR phụ thuộc vào gói cửa hàng của bạn: Dòng Tiền Pro ghi mã và đường dẫn thanh toán vào ghi chú hoặc dữ liệu bổ sung của đơn, và khi nền tảng cho phép thì hiện ở trang cảm ơn. Khi tiền về, Dòng Tiền Pro ghi nhận thanh toán cho đơn. Chi tiết này còn phụ thuộc quy định và giới hạn hiện hành của từng nền tảng, nên cấu hình thực tế có thể khác mô tả chung ở đây.

Một ứng dụng dùng chung nhiều cửa hàng

Ứng dụng Haravan và Shopify dùng chung một khoá ký cho mọi cửa hàng, nên Dòng Tiền Pro không tin nội dung webhook một mình. Mỗi webhook phải khớp tên miền cửa hàng đã kết nối, rồi hệ thống tải lại đơn bằng token của chính cửa hàng đó và chỉ dùng dữ liệu từ lần tải này.

Xem thêm hướng dẫn chi tiết tại Tích hợp Shopify và Tích hợp Haravan.

Các trường hợp đơn hàng

Tình huống	Cách xử lý
Khách trả đủ	Đơn đánh dấu đã thanh toán sau khi giao dịch xác thực
Khách trả thiếu	Yêu cầu hiện Thiếu tiền; đơn chưa đánh dấu
Khách trả thừa	Yêu cầu hiện Thừa tiền; bạn xử lý phần chênh
Đơn bị huỷ trên cửa hàng	Hệ thống xử lý theo trạng thái mới của đơn, không tự nhận tiền cho đơn đã huỷ
Đơn đã được thanh toán bên ngoài	Hệ thống không ghi nhận thanh toán lặp

Khi cửa hàng tạm lỗi

Việc ghi thanh toán về cửa hàng chạy nền và không chặn việc nhận tiền. Nếu cửa hàng lỗi, hệ thống thử lại tối đa 6 lần; hết lượt, tích hợp hiện nút Thử ghi lại để bạn chạy tay. Mỗi lần ghi có mã duy nhất nên thử lại không tạo thanh toán trùng. Giao dịch và mã DTP vẫn nằm trong sổ nên bạn đối chiếu được ở đối soát hoá đơn.

Mã đơn riêng của cửa hàng

Nếu cửa hàng đã dùng mã đơn dạng riêng trong nội dung chuyển khoản, khai báo mẫu ở Cài đặt › Thu tiền › Mẫu mã đơn để các quy tắc tích hợp lọc được; xem thu tiền VietQR. Mẫu này chỉ gợi ý, không thay mã DTP và không nâng mức tin cậy.

Giới hạn

• Tích hợp nhận sự kiện qua kênh cửa hàng; cửa hàng nào chưa kết nối thì không có tin về đơn.
• Mỗi cửa hàng chỉ gắn với một tích hợp đang hoạt động.
• Tích hợp không tính vào hạn mức giao dịch.