Cài SePay để app tự báo đã thu tiền

Cần chuẩn bị: tài khoản ngân hàng nhận tiền trọ, căn cước (CCCD) của chủ tài khoản và điện thoại đang nhận mã OTP của ngân hàng. SePay không hỏi mật khẩu ngân hàng. Nên mở song song 2 tab: một tab MONA (Cài đặt → Tài khoản NH), một tab SePay, làm qua lại cho nhanh.

SePay là dịch vụ đọc tin báo có của ngân hàng rồi báo sang MONA. Gói miễn phí được 50 lần nhận tiền mỗi tháng, mỗi phòng chuyển 1 lần thì đủ cho nhà dưới 50 phòng. Chế độ Sổ tay hay Chuyên nghiệp đều cài được.

Chuẩn bị bên MONA

1. 01

   Lưu tài khoản nhận tiền. Vào Cài đặt → Tài khoản NH, điền thẻ Tài khoản nhận tiền → bấm Lưu tài khoản. Bỏ qua nếu đã làm ở hướng dẫn 01.

   

2. 02

   Mở thẻ Tự đánh dấu đã thu (SePay) ngay bên dưới. Ở chế độ Sổ tay thẻ này gập sẵn, bấm vào tên thẻ để mở. Thẻ có 5 bước, làm xong bước nào bước đó hiện dấu xanh. Các phần dưới đây đi đúng theo 5 bước đó.

   

Bước 1 · Đăng ký SePay

1. 01

   Ở thẻ SePay bên MONA, bấm Mở trang SePay. Trang đăng ký SePay mở ở tab mới.

2. 02

   Điền thông tin, tạo tài khoản theo hướng dẫn trên màn hình rồi đăng nhập vào my.sepay.vn. Lần đầu vào, SePay để sẵn gói miễn phí.

3. 03

   Ở menu SePay, bấm Ngân hàng → bấm nút Kết nối tài khoản (góc trên bên phải) → chọn ngân hàng nhận tiền trọ. Chọn đúng ngân hàng và số tài khoản đã lưu bên MONA.

Bước 1 (tiếp) · Liên kết ngân hàng vào SePay

Tuỳ ngân hàng, SePay có 2 cách. Danh sách có thể thay đổi, lúc chọn ngân hàng SePay sẽ tự đưa đúng cách.

Cách 1 · Liên kết thẳng (nên dùng): MB, ACB, VietinBank, BIDV, VPBank, TPBank, Sacombank, OCB, MSB, KienLongBank. Tiền vào là SePay biết ngay, không tốn phí tin nhắn. Ví dụ với tài khoản MB cá nhân:

1. 01

   Chọn MB → ở Chọn loại tài khoản chọn Cá nhân → bấm Tiếp theo, rồi Tiếp theo lần nữa.

2. 02

   Hỏi Bạn đã có tài khoản chưa? thì chọn Đã có tài khoản → bấm Kết nối ngay.

3. 03

   Gõ Số tài khoản, Số CCCD và Số điện thoại đã đăng ký với ngân hàng → bấm Tiếp tục.

4. 04

   Ngân hàng gửi mã OTP về điện thoại. Gõ mã vào → bấm Liên kết API. Không thấy mã thì bấm Gửi lại mã.

   • TPBank, VPBank: SePay chuyển sang trang của ngân hàng, anh đăng nhập ở đó rồi bấm đồng ý chia sẻ.
   • Ngân hàng khác hỏi gần giống MB, cứ làm theo từng màn hình.

Cách 2 · Qua tin nhắn biến động số dư: cho ngân hàng không liên kết thẳng được, như Techcombank, Agribank, VIB, SHB, HDBank, Vietcombank tài khoản cá nhân.

1. 01

   Chọn SMS Báo số dư → chọn ngân hàng → gõ Số tài khoản và Tên chủ tài khoản → bấm Tiếp tục.

2. 02

   SePay đưa một số điện thoại. Ra quầy ngân hàng (hoặc gọi tổng đài ngân hàng) xin đăng ký thêm số đó nhận tin nhắn biến động số dư cho tài khoản này.

3. 03

   Chỉ đăng ký nhận tin biến động số dư, không đăng ký nhận OTP cho số đó. Ngân hàng có thể thu phí tin nhắn hằng tháng như bình thường.

Liên kết xong, tài khoản hiện trong menu Ngân hàng của SePay. Tiền vào tài khoản sẽ hiện ở menu Giao dịch.

Bước 2 · Tạo mã bí mật bên MONA

1. 01

   Quay lại tab MONA, ở thẻ SePay bấm Tạo mã bí mật.

   • Mã này để SePay chứng minh với MONA là chính nó gửi tin. Không đưa mã cho ai.
   • Mã chỉ hiện đủ một lần, tải lại trang là không xem lại được. Làm bước 3 ngay, đừng đóng tab.

Bước 3 · Tạo webhook bên SePay

Webhook là cái chuông báo: có tiền vào tài khoản là SePay báo sang MONA. Tạo một lần là xong.

1. 01

   Ở menu SePay, bấm Tích hợp → Webhooks → bấm Thêm webhook. Màn hình thêm webhook có 4 bước nhỏ.

2. 02

   Cơ bản:

   • Tên: gõ MONA House cho dễ nhận.
   • URL: bên MONA bấm Sao chép ở dòng Địa chỉ nhận báo có (URL) → dán vào. Địa chỉ đúng là https://mona.house/api/sepay/webhook.
   • Loại sự kiện: chọn Tiền vào.
   • Content-Type: để nguyên application/json.
   • Tự động gửi lại: bật. Mạng chập chờn thì SePay gửi lại, MONA không ghi trùng tiền.
3. 03

   Tài khoản:

   • Chọn tài khoản nhận tiền trọ vừa liên kết. SePay chỉ có mỗi tài khoản này thì chọn Tất cả tài khoản cũng được.
   • Bộ lọc tiền tố: để trống, không chọn gì.
   • Bỏ qua giao dịch không có mã: để tắt. Mã chuyển khoản của MONA (kiểu MAH001-T05) không theo kiểu mã của SePay, bật lên là SePay bỏ qua hết, MONA không nhận được tin.
4. 04

   Bảo mật: chọn API Key. Bên MONA bấm Sao chép ở dòng Mã bí mật (dán vào ô API Key) → dán vào ô API Key. Chỉ dán mã, không gõ thêm chữ gì.

5. 05

   Cảnh báo: để mặc định, bấm Thêm để lưu. Webhook mới hiện trong danh sách, cột Trạng thái đang Bật.

Chữ trên màn hình SePay có thể khác đôi chút mỗi lần SePay cập nhật. Cứ giữ đúng 4 ý: tiền vào, URL của MONA, API Key là mã bí mật, không lọc mã.

Bước 4 và 5 · Chuyển thử rồi bật

1. 01

   Chuyển thử 1.000đ. Nhờ người nhà chuyển 1.000đ vào tài khoản trọ. Nội dung ghi gì cũng được.

   • Muốn thấy tận mắt hoá đơn tự đổi trạng thái thì ghi mã chuyển khoản của một hoá đơn đang nợ, ví dụ MAH001-T05. 1.000đ đó được trừ vào hoá đơn, khách trả phần còn lại như thường.
   • Khoảng 5 giây sau tải lại trang MONA, bước 4 hiện Chuyển thử thành công màu xanh.
2. 02

   Bật tự đánh dấu. Gạt công tắc ở bước 5 sang Đang bật. Xong. Thẻ gọn lại, ghi số tài khoản và lần báo có gần nhất.

Có an toàn không?

• SePay chỉ đọc tin báo có, không chuyển tiền đi được. Liên kết xong cũng không ai rút được tiền qua SePay.
• MONA chỉ nhận số tiền, nội dung và mã giao dịch của từng khoản tiền vào. MONA không biết mật khẩu ngân hàng, không biết số dư.
• Muốn thôi: bên MONA bấm Xoá tài khoản ngân hàng và cấu hình SePay; bên SePay tắt hoặc xoá webhook, huỷ liên kết ngân hàng trong menu Ngân hàng.

Nếu có trục trặc