Ví API

Ví API là ví tiền riêng dành cho tài khoản đã được duyệt dùng API. Số dư trong ví dùng để thanh toán các đơn mua, gia hạn, nâng cấp dịch vụ tạo qua API - và cả khi bạn thanh toán trên website. Trang này giúp bạn xem số dư, nạp tiền bằng mã QR chuyển khoản, đặt cảnh báo khi số dư thấp và tra cứu lịch sử.

1. Tổng quan màn hình

• Thẻ Số dư Ví API (khung màu): số tiền hiện có và nút Nạp tiền.
• Khung Cảnh báo số dư thấp (bên phải): mức số dư mà dưới đó hệ thống gửi email nhắc bạn nạp thêm.
• Hai tab bên dưới: Đơn nạp (các lần bạn tạo lệnh nạp tiền) và Biến động số dư (mọi lần ví được cộng / trừ tiền).

2. Nạp tiền vào Ví API

1. 1
   Bấm nút Nạp tiền trên thẻ số dư.
2. 2
   Nhập Số tiền nạp vào ví (VNĐ) - đây là số tiền ví sẽ được cộng - hoặc bấm nhanh một mức có sẵn (500.000 đến 10.000.000). Mức tối thiểu hiện ngay dưới ô nhập.
3. 3
   Chọn Hóa đơn cho khoản nạp (nếu có nhiều lựa chọn - xem bảng bên dưới).
4. 4
   Xem lại khung tóm tắt: Cộng vào Ví API, VAT và Số tiền cần chuyển khoản.
5. 5
   Bấm Tạo mã QR. Cửa sổ chuyển sang bước chuyển khoản (xem mục 3).

Các lựa chọn hóa đơn

Những lựa chọn bạn thấy phụ thuộc vào loại tài khoản (cá nhân / doanh nghiệp) và tài khoản nhận tiền đang mở. Nếu chỉ có một lựa chọn, cửa sổ chỉ hiển thị thông tin, không cần chọn.

Hóa đơn của các khoản nạp có xuất hóa đơn được xem ở mục Hóa đơn trên menu trái (cột mã đơn hiện mã nạp, ví dụ SAPI…).

3. Chuyển khoản theo mã QR

Sau khi tạo mã QR, cửa sổ hiện tiêu đề Đơn nạp SAPI… cùng mã QR và thông tin chuyển khoản: Ngân hàng, Số tài khoản, Chủ tài khoản, Số tiền, Nội dung.

1. 1
   Mở ứng dụng ngân hàng, quét mã QR - số tiền và nội dung được điền sẵn. Hoặc chuyển khoản thủ công: bấm để sao chép số tài khoản, số tiền, nội dung.
2. 2
   Giữ cửa sổ mở: dòng Đang chờ nhận tiền... nghĩa là hệ thống đang tự kiểm tra (khoảng 5 giây một lần). Khi tiền về, cửa sổ đổi sang Nạp tiền thành công và số dư được cập nhật ngay.
3. 3
   Lỡ đóng cửa sổ? Không sao - tiền về vẫn được cộng. Muốn xem lại mã QR, bấm Xem QR ở dòng đơn nạp tương ứng trong tab Đơn nạp.

4. Theo dõi đơn nạp

Tab Đơn nạp liệt kê các lệnh nạp tiền, mới nhất ở trên (10 dòng mỗi trang).

• Chờ thanh toán - đã tạo mã QR, hệ thống đang chờ nhận tiền.
• Thành công - đã nhận tiền và cộng vào ví.
• Hết hạn - quá hạn thanh toán mà chưa nhận được tiền. Đừng chuyển khoản theo đơn này nữa, hãy tạo đơn mới.
• Đã hủy - đơn nạp đã bị hủy; tạo đơn mới nếu bạn vẫn muốn nạp.

5. Xem biến động số dư

Tab Biến động số dư là "sổ phụ" của ví: mỗi dòng là một lần ví được cộng (số xanh, dấu +) hoặc bị trừ (số đỏ, dấu −), kèm Số dư sau giao dịch.

6. Đặt cảnh báo số dư thấp

Khi phần mềm của bạn mua / gia hạn tự động, ví hết tiền giữa chừng sẽ khiến đơn bị từ chối. Đặt ngưỡng cảnh báo để được nhắc nạp tiền kịp thời:

1. 1
   Ở khung Cảnh báo số dư thấp, bấm Sửa.
2. 2
   Nhập mức số dư (ví dụ 500.000) rồi bấm Lưu.

Khung sẽ hiện "Gửi email khi số dư dưới …". Muốn tắt cảnh báo: bấm Sửa, để trống ô nhập rồi bấm Lưu - khung hiện Đang tắt. Nếu bạn đã khai báo webhook, hệ thống cũng gửi thông báo "Số dư Ví API thấp" tới máy chủ của bạn.

7. Ví API được dùng ở đâu?

• Đơn tạo qua API - mua mới, gia hạn, nâng cấp: tiền được trừ thẳng vào ví. Ví không đủ thì yêu cầu bị từ chối với mã lỗi INSUFFICIENT_BALANCE.
• Thanh toán trên website - khi thanh toán đơn mua mới / nâng cấp (ở trang chi tiết đơn hàng) hoặc giỏ gia hạn, bạn có thêm lựa chọn thanh toán bằng Ví API (không tính VAT). Ví thiếu tiền thì bấm Nạp thêm vào Ví API →, hoặc chọn chuyển khoản QR nếu đơn đó cho phép.
• Tự động gia hạn bằng Ví API - bật ở trang chi tiết từng dịch vụ. Trước hạn 3 ngày, hệ thống tự gia hạn thêm 1 chu kỳ và trừ ví (giá chưa VAT). Ví không đủ thì không gia hạn, bạn được báo qua email / webhook và hệ thống thử lại vào các ngày sau.

8. Câu hỏi thường gặp