Cấu hình thanh toán SePay và cách VOMA nhận diện tiền

Bài này giúp bạn bật nhận thanh toán chuyển khoản tự động qua SePay. Bạn cũng sẽ biết VOMA quyết định một đơn đã được trả tiền như thế nào.

Trước khi bắt đầu

Bạn cần tài khoản quản trị (admin) để lưu cấu hình. Tài khoản khác mở xem được màn hình này nhưng lưu sẽ bị từ chối.

Cấu hình SePay

1. Vào Cài đặt hệ thống > Cấu hình SePay.
2. Nhập đủ bốn ô bắt buộc trong form Thông tin cấu hình Cổng thanh toán SePay: SePay Merchant ID, SePay Secret Key, SePay Checkout URL và Web Base URL.
3. Bấm biểu tượng con mắt ở ô Secret Key để hiện hoặc ẩn chữ đang gõ. Ô này mặc định ẩn dạng dấu chấm.
4. Bấm Lưu cấu hình.

Lưu ý

Sau khi lưu, Secret Key hiện lại dưới dạng che bằng dấu *. VOMA mã hoá thông tin này và không hiển thị lại chữ gốc trên màn hình.

Kiểm tra kết nối

1. Bấm Test Connection.
2. Đọc dòng thông báo kết quả.

Cẩn thận

Test Connection chỉ gửi yêu cầu tới địa chỉ ở ô SePay Checkout URL. Màn hình vẫn báo Kết nối tới SePay thành công. khi địa chỉ phản hồi bất kỳ điều gì không phải lỗi phía máy chủ SePay, thậm chí cả khi không kết nối được. Dòng này không xác nhận SePay Merchant ID và SePay Secret Key đúng. Để chắc chắn, hãy chuyển khoản thử với nội dung đúng mã một đơn thử và xem giao dịch có về đúng đơn không.

Cách VOMA tự tìm đơn

Khi có tiền chuyển vào tài khoản đã đấu nối SePay, SePay gửi giao dịch về VOMA. VOMA ghi lại giao dịch rồi thử tìm đơn theo thứ tự sau và dừng ngay khi tìm thấy:

1. So khớp chính xác nội dung chuyển khoản với mã đơn. Mã đơn phải ghi đúng và đầy đủ.
2. So khớp chính xác nội dung chuyển khoản với mã giao dịch SePay đã gắn cho đơn từ trước. Cách này dùng khi đơn đã có một liên kết thanh toán trước đó.
3. Trích một cụm giống mã đơn trong nội dung chuyển khoản rồi so với mã đơn. Ví dụ cụm bắt đầu bằng ORD-, hoặc chuỗi chữ và số liền nhau dài 6-20 ký tự. Cách này dùng khi nội dung có thêm chữ khác quanh mã đơn.
4. So khớp mã giao dịch do SePay cấp với mã giao dịch đã gắn cho đơn. Cách này dùng khi không dựa được vào nội dung chuyển khoản.

Nếu không cách nào khớp, VOMA ghi nhận giao dịch không khớp được đơn và không cập nhật đơn nào. Màn hình Đơn hàng không hiện cảnh báo. Bạn phải tra sao kê ngân hàng hoặc SePay để phát hiện.

Lưu ý về số tiền chuyển khoản

Cẩn thận

Ở cả bốn cách trên, VOMA chỉ so nội dung hoặc mã giao dịch, không so số tiền chuyển khoản với TỔNG ĐƠN HÀNG ở bất kỳ bước nào.

Nếu nội dung chuyển khoản đúng mã đơn, dù khách chuyển ít hơn hay nhiều hơn, VOMA vẫn:

• Đánh dấu toàn bộ đơn là đã trả tiền (PAID).
• Ghi thời điểm trả tiền là lúc nhận được giao dịch.
• Không báo chênh lệch hay tạo dòng chênh lệch nào trên màn hình.

Ví dụ, đơn có TỔNG ĐƠN HÀNG 500.000đ nhưng khách chuyển 10.000đ ghi đúng mã đơn (dù nhầm hay cố ý). VOMA vẫn ghi PAID như đã nhận đủ 500.000đ.

Vì vậy, bước đối chiếu số tiền thực nhận với TỔNG ĐƠN HÀNG trong bài Đối soát đơn hàng với tiền thu và hoá đơn là cách duy nhất để phát hiện trường hợp này. VOMA không tự làm việc đó.

Tự động xuất hoá đơn

Khi đơn sang PAID, VOMA có thể tự gửi thông tin sang hệ thống hoá đơn, tuỳ phương thức thanh toán ghi trên đơn.

• Đơn không phải COD (SePay, VNPay, MoMo...) được coi là đơn trả trước. VOMA gửi yêu cầu xuất hoá đơn ngay lúc đơn thành PAID. Số tiền hoá đơn tính theo toàn bộ giá trị đơn, không theo số tiền vừa nhận.
• Đơn COD: VOMA không gửi ở bước này. VOMA chỉ gửi khi đơn sang COMPLETED.

Nghĩa là nếu một giao dịch sai số tiền khớp vào đơn trả trước, VOMA có thể đã gửi yêu cầu xuất hoá đơn cho toàn bộ giá trị đơn trước khi ai kịp phát hiện.

Việc gửi chạy ngầm. Nếu lần đầu không thành công, VOMA tự thử lại ở các mốc khoảng 1, 5, 15, 60 và 120 phút sau lần đầu (tổng cộng khoảng 81 phút). Nếu tới lần thử cuối vẫn không xong, VOMA ngừng thử lại hẳn cho lần phát sinh đó. VOMA không có nơi nào cho bạn xem đã gửi thành công, đang thử lại hay đã ngừng. Muốn biết, hãy tra ở hệ thống hoá đơn nhận thông tin này.

Xong khi nào

Bạn cấu hình xong khi một giao dịch chuyển khoản thử, ghi đúng mã đơn thử, về đúng đơn đó và đơn chuyển sang PAID.

Hay gặp

• Hiện tượng: Muốn tạo đường link thanh toán cho một đơn để gửi khách. VOMA chưa có nút nào làm việc này trên màn hình, dù phía hệ thống đã có khả năng đó.
• Hiện tượng: Muốn xem danh sách giao dịch đã nhận, chi tiết từng giao dịch, trạng thái gửi hoá đơn tự động hoặc cảnh báo lệch tiền. VOMA chưa có màn hình nào hiển thị các thông tin này.
• Hiện tượng: Muốn đổi thứ tự ưu tiên các cách so khớp. VOMA không cho đổi từ màn hình.
• Hiện tượng: Khách chuyển sai số tiền cho đơn trả trước. VOMA có thể đã gửi yêu cầu xuất hoá đơn cho toàn bộ giá trị đơn trước khi bạn phát hiện lệch tiền.