Tài liệu

Thanh toán: SePay, MoMo, ZaloPay

Thương hiệu trả phần còn nợ của tháng đã chốt bằng chuyển khoản, VietQR hoặc ví.

Kho trừ phí dịch vụ tháng vào tiền COD thu hộ cho thương hiệu. Tháng nào COD không đủ thì thương hiệu nợ phần còn lại. Khi tháng đã chốt, trang hoá đơn hiện thẻ "Thanh toán phần còn lại" với:

  • số còn nợ, đã trả, còn lại;
  • mã thanh toán dạng HD<mã thương hiệu><yymm>;
  • mã VietQR điền sẵn số tiền và nội dung, khi máy chủ có tài khoản nhận;
  • nút thanh toán bằng MoMo hoặc ZaloPay, khi đã bật.

Mỗi khoản tiền được ghi một lần theo mã giao dịch của đối tác, nên thông báo gửi lại không bị ghi trùng.

Tình trạng. Chữ ký MoMo và ZaloPay đã được máy chủ thử (sandbox) của hai bên chấp nhận. Việc hỏi trạng thái ví, các mã kết quả và thời gian sống của link được viết theo tài liệu công khai và kiểm bằng ví giả; chưa chạy trên sandbox của MoMo và ZaloPay. SePay, MISA và hãng vận chuyển cần tài khoản riêng nên được kiểm bằng máy chủ giả.

Quy tắc bảo vệ tiền

  • Chưa có bảng kê COD của hãng thật: thương hiệu có kiện COD đi GHN hoặc GHTK thật mà BayHub chưa nhập bảng kê của hãng thì chưa mở thanh toán trực tuyến cho tháng đó, vì số nợ chưa đúng. Chuyển khoản đến vẫn được ghi nhận.
  • Trả dư: phần dư thành số dư, tự trừ vào số nợ các tháng sau.
  • Một lượt mở tại một thời điểm: bấm hai lần, mở hai tab, hay hai ví cũng chỉ mở một lượt thanh toán.
  • Ví không báo kết quả: cứ 5 phút BayHub hỏi ví về các lượt đã hết hạn mà chưa có kết quả. Đã trả thì ghi theo mã giao dịch của ví; mã lạ không đoán, lượt đó vẫn chờ và việc nền báo lỗi.

Bạn cần chuẩn bị

Phương thứcCần có
SePay (chuyển khoản)Tài khoản SePay liên kết ngân hàng nhận tiền, khoá API cho webhook, mã và số tài khoản nhận. Khi có số tài khoản, BayHub chỉ ghi nhận khoản chuyển vào đúng tài khoản đó
MoMoThông tin merchant (partnerCode, accessKey, secretKey), môi trường test trước
ZaloPayThông tin ứng dụng (app id, key1, key2), môi trường sandbox trước

Mỗi phương thức tắt cho tới khi máy chủ có khoá tương ứng. Giao dịch chuyển khoản không có mã khớp nằm ở mục "Chuyển khoản chưa khớp hoá đơn" cho kế toán xem.