Giới thiệu chung

Bắt đầu

Chào mừng bạn đến trang tài liệu của VZpay.

Hướng dẫn lập trình tích hợp VZpay để xử lý giao dịch Thanh toán chuyển khoản quét mã QR của khách hàng.

Xác nhận đơn hàng tức thời với VZpay và không cần qua trung gian.

Cách tích hợp VZpay với hệ thống của người dùng

  • Code để tạo link thanh toán

  • Code xử lý returnUrlcancelUrl để nhận thông báo kết quả Thanh toán và Huỷ đơn hàng trên giao diện.

  • Code webhook để nhận kết quả thanh toán của một đơn hàng.

Luồng hoạt động

  • Bước 1: Khách hàng thực hiện mua hàng trên Website hoặc ứng dụng của người dùng và lựa chọn thanh toán chuyển khoản quét mã QR cho đơn hàng.

  • Bước 2: Website hoặc ứng dụng của người dùng tiến hành gọi tạo link thanh toán, VZpay sẽ kiểm tra dữ liệu và trả về kết quả chứa link thanh toán. Khi hệ thống của người dùng nhận kết quả link thanh toán cần chuyển hướng khách hàng của bạn đến trang checkout của VZpay bằng cách mở link thanh toán từ kết quả.

  • Bước 3: Khách hàng sử dụng ứng dụng ngân hàng để quét mã QR từ link thanh toán.

  • Bước 4: Giao dịch ghi nhận thành công tại ngân hàng, VZpay sẽ trả kết quả thành công về returnUrl gồm: trạng thái, mã đơn hàng, mã giao dịch, ... Từ kết quả nhận được trên returnUrl Website hoặc ứng dụng của người dùng hiển thị giao diện thành công.

  • Bước 5: Sau khi có kết quả ở giao diện, đồng thời VZpay sẽ gửi một kết quả với đầy đủ thông tin thanh toán tới Webhook của cửa hàng được thiết lập trên My VZpay, sau đó nguời dùng cập nhật trạng thái đơn hàng phù hợp.

Rate limits

Để đảm bảo dịch vụ ổn định, VZpay API xác định giới hạn truy cập trên mỗi lần gọi.

Nếu thực hiện quá nhiều yêu cầu cùng một lúc, thì bạn sẽ nhận một kết quả HTTP là 429 Too Many Requests

Last updated