01Trước khi bắt đầu
- Tính năng đối soát SePay có ở gói Pro và thời gian dùng thử (xem Bảng giá).
- Bạn cần tài khoản đăng nhập my.sepay.vn và quyền quản lý tài khoản ngân hàng nhận tiền của tiệm.
- Tiệm chưa có SePay thì báo đội hỗ trợ: tài khoản ngân hàng của tiệm có thể được thêm vào SePay của Tiệm Của Tui, bạn không cần làm các bước dưới.
02Thêm tài khoản ngân hàng vào SePay
- Đăng nhập my.sepay.vn.
- Thêm tài khoản ngân hàng mà khách chuyển khoản vào (tài khoản nhận tiền đã cài trong app, ở Quản lý → Chi nhánh).
- Làm theo hướng dẫn của SePay để liên kết ngân hàng, tới khi SePay nhận được giao dịch của tài khoản đó.
Tiệm có nhiều chi nhánh dùng tài khoản riêng thì thêm từng tài khoản.
03Báo đội hỗ trợ để liên kết
Gửi đội hỗ trợ ngân hàng và số tài khoản vừa thêm. Đội hỗ trợ liên kết tài khoản đó với tiệm của bạn trong hệ thống.
Liên kết xong, màn Quản lý → Chi nhánh trong app hiện nhãn "Đã liên kết SePay · tự đối soát" cạnh tài khoản.
04Nhận đường dẫn và mã bí mật
Đội hỗ trợ gửi cho chủ tiệm hai thông tin riêng của tiệm:
- Đường dẫn webhook, dạng
https://api.tiemcuatui.vn/api/webhooks/sepay/… - Mã bí mật để SePay ký từng thông báo.
05Tạo webhook trên SePay
Trên my.sepay.vn, vào mục tích hợp WebHooks và thêm webhook mới với các cài đặt sau (tên mục có thể khác đôi chút tuỳ phiên bản SePay):
- Tên
- Tiệm Của Tui
- Sự kiện
- Có tiền vào
- Tài khoản ngân hàng
- Các tài khoản đã báo đội hỗ trợ ở bước 3
- Bỏ qua nếu không có mã thanh toán
- Không (app tự tìm mã trong nội dung chuyển khoản)
- Gọi đến URL
- Đường dẫn webhook nhận ở bước 4
- Kiểu chứng thực
- HMAC-SHA256, dán mã bí mật nhận ở bước 4
- Kiểu nội dung
- application/json
- Tự động gửi lại khi lỗi
- Bật
Lưu webhook. Không cần gửi lại cho đội hỗ trợ đường dẫn hay mã bí mật.
06Chuyển thử
- Tạo một đơn nhỏ trong app, ví dụ 2.000đ, chọn thanh toán chuyển khoản để hiện QR.
- Dùng app ngân hàng quét QR và chuyển, giữ nguyên nội dung chuyển khoản.
- Chụp ảnh xác nhận như bình thường. Sau ít phút, lần chuyển khoản đổi từ "Đang đợi đối soát" sang "Đã đối soát".
- Huỷ đơn thử nếu không cần giữ.
Quá 15 phút vẫn "Đang đợi đối soát" thì xem lịch sử gửi webhook trên SePay và báo đội hỗ trợ.
07Xử lý sự cố
- Lộ mã bí mật (gửi nhầm, nhân viên cũ biết): báo đội hỗ trợ để cấp mã mới, rồi cập nhật lại webhook trên SePay. Mã cũ hết hiệu lực ngay.
- Đổi tài khoản ngân hàng: thêm tài khoản mới vào SePay và vào webhook, báo đội hỗ trợ liên kết tài khoản mới và bỏ tài khoản cũ.
- Tiền vào nhưng không tự khớp đơn (khách sửa nội dung, chuyển không theo QR): khoản đó nằm ở mục "Đối soát ngân hàng" trên màn chốt sổ, chủ tiệm nhập mã đơn để ghép tay.
- Ngân hàng nhận ít hơn số thu ngân ghi: app hiện cảnh báo trên đơn; đơn đã hoàn thành sẽ thành đơn thiếu tiền để thu thêm.