Kết nối SePay how-to

Tab Thanh toán trong trang Kênh (/app/channels) là nơi bạn cấu hình cổng thanh toán. Khuyến nghị kết nối SePay OAuth (tự động), ngoài ra còn MoMo/VNPay/VietQR (thủ công).

Tổng quan SePay trước

Nếu chưa rõ SePay là gì / khác gì MoMo, đọc tổng quan SePay trước. Trang này chỉ tập trung thao tác kết nối.

4 cổng thanh toán trong tab

Cổng	Loại	Khuyên dùng
SePay	OAuth tự động	⭐ Ưu tiên
VietQR	Nhập STK thủ công	Dự phòng
MoMo	Nhập credentials	Tuỳ
VNPay	Nhập credentials	Tuỳ

Chỉ SePay là auto-confirm

MoMo / VNPay / VietQR (manual) không tự xác nhận khi khách CK — bạn phải đối soát tay. Nếu muốn AI tự báo “đã thanh toán” cho khách → bắt buộc dùng SePay OAuth.

SePay OAuth wizard — 3 bước

Bấm Kết nối SePay ngay → mở wizard 3 bước.

Bước 1: Đăng nhập SePay

Popup mở trang SePay (my.sepay.vn). Đăng nhập bằng tài khoản SePay của bạn (đăng ký riêng ở sepay.vn nếu chưa có).

Phải có tài khoản SePay

SePay là dịch vụ riêng — bạn phải có tài khoản ở sepay.vn trước. Nếu chưa → vào sepay.vn đăng ký (SePay thu phí riêng theo gói của họ, độc lập với TrolyPage).

Sau khi đăng nhập → cấp quyền cho ứng dụng TrolyPage (OAuth2).

Bước 2: Chọn tài khoản ngân hàng

Sau khi OAuth xong, SePay trả về danh sách tài khoản ngân hàng bạn đã liên kết trong SePay. Chọn 1 STK làm nguồn nhận thanh toán:

• Dropdown: -- Chọn tài khoản ngân hàng --.
• Hiển thị: tên ngân hàng + STK + chủ TK.
• Nếu SePay chỉ có 1 STK hoạt động → tự liên kết luôn, không cần chọn.

Bước 3: Liên kết + tự tạo webhook

Bấm Liên kết ngân hàng → TrolyPage:

1. Lưu cấu hình (STK + bank brand + token SePay).
2. Tự động tạo webhook phía SePay để nhận giao dịch đến.
3. Trở về tab Thanh toán → STK xuất hiện trong list đã kết nối.

Webhook chưa tạo

Nếu thấy cảnh báo “Webhook trên SePay chưa được tạo; giao dịch sẽ chưa tự động đồng bộ” → vào trang SePay tự tạo webhook tay.

Sau khi kết nối

Box “Đã kết nối SePay OAuth” hiển thị:

• STK + ngân hàng + chủ Tk.
• Trạng thái: Hoạt động (webhook đã tạo) / Cảnh báo (webhook thiếu).
• Tên cấu hình (để phân biệt nếu nhiều STK).
• Ngắt kết nối — gỡ SePay (đơn mới sẽ không auto-confirm).
• Làm mới — re-fetch danh sách STK từ SePay.

Khi nào “Chưa thể kết nối SePay”

Nếu thấy alert “Chưa thể kết nối SePay”:

• TrolyPage chưa cấu hình SePay OAuth client ở tầng platform.
• Hoặc SePay đang bảo trì.

Liên hệ hotro@trolypage.com — đây không phải lỗi phía shop bạn.

Cổng dự phòng — VietQR manual

Nếu không dùng SePay được, dùng VietQR (manual):

1. Tab Thanh toán → panel VietQR.
2. Nhập: tên ngân hàng + STK + chủ Tk + chi nhánh.
3. Lưu.

VietQR sẽ sinh QR đúng (vẫn dùng img.vietqr.io) nhưng không tự xác nhận — khi khách CK xong, bạn phải:

1. Mở app ngân hàng check.
2. Vào Đơn hàng → đơn đó → bấm Xác nhận đã thanh toán tay.

VietQR tốt hơn không gì

Nếu không có SePay, ít nhất cấu hình VietQR để AI gửi QR cho khách (tránh gửi STK dạng text dễ sai). Việc duyệt thanh toán tay chỉ tốn thêm 30 giây/đơn.

MoMo / VNPay

MoMo và VNPay là cổng thanh toán online khác (QR động, redirect). Cấu hình cần:

• MoMo: Partner Code + Access Key + Secret Key (từ MoMo merchant).
• VNPay: Tmn Code + Hash Secret (từ VNPay merchant).

MoMo/VNPay cần tài khoản merchant

Cả 2 đều yêu cầu shop bạn đăng ký tài khoản merchant riêng với MoMo/VNPay (có phí + duyệt). Khác SePay — SePay là cá nhân, đăng ký dễ hơn.

MoMo/VNPay phù hợp shop có website riêng, lượng giao dịch lớn, cần QR động 1 lần. Đa số shop bán qua chat MXH → SePay + VietQR là đủ.

Chọn cổng nào

Tình huống	Cổng
Shop nhỏ, bán qua chat FB/Zalo	SePay
Không có tài khoản SePay	VietQR manual
Có website + lượng giao dịch lớn	+ MoMo / VNPay
Muốn nhiều phương thức	Cả 4 (QR AI gửi sẽ chọn theo ưu tiên)

Bước tiếp theo

• Tổng quan SePay — concept + 2 luồng.
• Checkout how-to — luồng B (trả phí TrolyPage).
• Đơn hàng — đơn tự xác nhận khi CK.
• Tab Vận chuyển — tab kế bên.