Hướng dẫn

Cấu hình webhook SePay

Dành cho tiệm tự có tài khoản SePay. Sau khi làm xong, mỗi khoản tiền khách chuyển vào tài khoản của tiệm được SePay báo về, app tự khớp với đơn theo mã thanh toán trên QR.

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

  1. Đăng nhập my.sepay.vn.
  2. 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).
  3. 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.
Hai thông tin này chỉ gửi qua Zalo hoặc gọi điện trực tiếp cho chủ tiệm, và mã bí mật chỉ đọc một lần. Đội hỗ trợ không bao giờ hỏi mật khẩu SePay hay mật khẩu ngân hàng của bạn.

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ử

  1. Tạo một đơn nhỏ trong app, ví dụ 2.000đ, chọn thanh toán chuyển khoản để hiện QR.
  2. Dùng app ngân hàng quét QR và chuyển, giữ nguyên nội dung chuyển khoản.
  3. 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".
  4. 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.