Bạn cần: một tài khoản ngân hàng đứng tên bạn (hoặc công ty), và điện thoại đăng ký với ngân hàng đó.
1. Tạo tài khoản SePay
- Vào my.sepay.vn và đăng ký bằng email.
- Điền thông tin công ty hoặc cá nhân theo hướng dẫn trên màn hình.
2. Nối tài khoản ngân hàng
- Trong SePay, mở menu Ngân hàng, bấm + Kết nối tài khoản.
- Chọn cách nối. Ngân hàng nào SePay hỗ trợ API (như Vietcombank, ACB, BIDV, TPBank) thì nối qua API sẽ nhận giao dịch tức thì. Ngân hàng khác thì chọn SMS báo số dư.
- Điền đúng số tài khoản và tên chủ tài khoản, làm theo các bước xác nhận của SePay.
Khi xong, tài khoản hiện trong danh sách Ngân hàng. Trong trang Cất cánh của Kite, bạn sẽ điền lại ba thông tin: Mã ngân hàng (viết tắt như SePay hiển thị, ví dụ VCB, MB, TCB), Số tài khoản nhận và Tên chủ tài khoản. Người mua thấy tên này khi chuyển khoản.
3. Lấy API token
- Trong SePay, vào Cấu hình Công ty, rồi API Access (bản giao diện cũ ghi Cài đặt → API Access).
- Bấm nút thêm ở góc trên bên phải.
- Đặt tên bất kỳ (ví dụ "Kite"), trạng thái Hoạt động, bấm Thêm.
- Chép token vừa tạo, dán vào ô SePay API token trong Kite.
Kite dùng token này để đối soát lại giao dịch khi có webhook báo trễ.
4. Tạo webhook
Trong Kite, đặt trước một Khoá webhook: một chuỗi dài bạn tự nghĩ ra, đủ khó đoán. Kite lưu lại, sau đó hiện ô Webhook URL để bạn chép.
Rồi trong SePay:
- Mở menu Webhooks, bấm nút thêm webhook ở góc trên bên phải.
- Bước thông tin: đặt tên, chọn sự kiện Có tiền vào, dán Webhook URL chép từ Kite.
- Bước tài khoản: chọn tài khoản ngân hàng vừa nối.
- Bước bảo mật: chọn kiểu chứng thực API Key, dán đúng Khoá webhook bạn đặt ở Kite.
- Bấm Thêm.
Hai bên phải khớp từng ký tự, nếu không Kite sẽ từ chối webhook.
5. Chọn chế độ và thử
- Chọn chế độ Thật: Kite nhận tiền thật từ học viên. Muốn thử thì tự chuyển 10.000 ₫ vào chính tài khoản của bạn.
- Bấm Lưu thông tin SePay, rồi Bắt đầu.
- Chuyển thật 10.000 ₫ vào tài khoản nhận, ghi đúng nội dung chuyển khoản Kite hiện ra sau khi bấm Bắt đầu. Kite chờ tối đa 5 phút và tự ghi khoản này là giao dịch thử, không đưa vào Thanh toán cần xem.
- Muốn thử nhanh hơn, trong SePay bấm Gửi thử ở webhook vừa tạo cũng được. Nếu khoản thử đó hiện ở Thanh toán cần xem, bạn bấm Bỏ qua một cái là xong.
Thấy dòng "SePay đã nối" là xong.
Nếu bị lỗi
| Kite báo | Cách sửa |
|---|---|
| "Chưa nhận được webhook nào từ SePay trong 5 phút" | Chuyển thật 10.000 ₫ với đúng nội dung Kite hiện ra, hoặc trong SePay mở Webhooks rồi bấm Gửi thử. Kiểm tra URL webhook và Khoá webhook ở Kite khớp từng ký tự với webhook bên SePay, kiểm tra webhook đã chọn đúng tài khoản ngân hàng và sự kiện Có tiền vào, rồi bấm Bắt đầu lại. |
| "SePay từ chối API token" | Tạo lại token ở Cấu hình Công ty → API Access, dán lại. Chế độ Thử nghiệm hay Thật phải đúng với token. |
| "Không đọc được danh sách giao dịch SePay" | Webhook đã tới nên hai bên đã nối. Đọc chi tiết lỗi Kite in bên dưới rồi thử lại sau ít phút. |
Vẫn kẹt: gửi mình email tại [email protected], kèm ảnh màn hình.