Kết nối SePay how-to

This content is not available in your language yet.

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).

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ó).

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:

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

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):

Tab Thanh toán → panel VietQR.
Nhập: tên ngân hàng + STK + chủ Tk + chi nhánh.
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:

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

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 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.