API VA theo Đơn hàng

API VA (Virtual Account) theo đơn hàng là giải pháp tự động hóa xác nhận thanh toán. Thay vì sử dụng một VA cố định, mỗi đơn hàng sẽ được cấp một VA riêng với số tiền khớp chính xác.

API VA theo Đơn hàng cho BIDV doanh nghiệp
API VA theo Đơn hàng cho BIDV doanh nghiệp

Giải thích luồng hoạt động

Khi khách hàng thực hiện thanh toán qua VA (Virtual Account), toàn bộ quá trình được xử lý tự động theo các bước sau:

  1. Sau khi khách hàng hoàn tất đơn hàng trên website của bạn, hệ thống sẽ tự động kết nối với SePay thông qua API để tạo một đơn hàng mới. SePay sẽ trả về một số VA duy nhất cho đơn hàng này.
  2. Website của bạn ngay lập tức hiển thị thông tin thanh toán cho khách hàng, bao gồm:
    • Số tài khoản VA cần chuyển khoản
    • Số tiền cần thanh toán chính xác
    • Thời gian VA có hiệu lực
    • Mã QR để quét thanh toán nhanh
  3. Khách hàng có thể dễ dàng thanh toán bằng cách quét mã QR hoặc chuyển khoản trực tiếp đến số VA được cấp.
  4. Ngay khi giao dịch được thực hiện thành công, ngân hàng sẽ tự động gửi thông báo đến SePay để xác nhận thanh toán.
  5. SePay nhận được thông báo và ngay lập tức chuyển tiếp thông tin này đến website của bạn thông qua Webhook
  6. Hệ thống của bạn xử lý thông tin nhận được, cập nhật trạng thái đơn hàng và hiển thị thông báo xác nhận thanh toán thành công cho khách hàng.

Ưu điểm chính

Kiểm soát số tiền

VA gắn với số tiền của đơn hàng. Với API v1 (BIDV), khoản chuyển lớn hơn số tiền của VA bị từ chối. Muốn thu nhiều đợt (thanh toán từng phần), đặt số tiền của VA nhỏ hơn số tiền đơn hàng. VA tạo không kèm số tiền có thể nhận nhiều lần thanh toán.

Độc lập hoàn toàn

Mỗi đơn hàng có một VA riêng nên không phụ thuộc vào nội dung chuyển khoản, tránh được các lỗi do khách hàng điền sai nội dung.

Hạn chế trùng lặp

Với API v1 (BIDV), VA ngừng nhận tiền khi nhận một khoản chuyển bằng đúng số tiền của VA, khi đơn hàng đã được thanh toán đủ, hoặc khi hết hạn (nếu bạn truyền thời gian hiệu lực), giúp hạn chế tình trạng thanh toán trùng lặp.

Tích hợp dễ dàng

API RESTful được thiết kế chuyên nghiệp với tài liệu đầy đủ, dễ dàng tích hợp vào mọi nền tảng.

Ngân hàng hỗ trợ

API v2 hỗ trợ VA theo đơn hàng cho tài khoản BIDV, Sacombank, Vietcombank, VietinBank và Shinhan Bank. Xem tài liệu VA theo đơn hàng (API v2) trên developer.sepay.vn.