Quy trình tạo booking (B2C Online)

Sơ đồ dưới đây mô tả quy trình từ lúc khách hàng xem danh sách vé đến khi thanh toán thành công và nhận vé qua ứng dụng B2C.

Các bước chi tiết

Lấy danh sách vé: Gọi API /api/v1/sale-packages để lấy danh sách các dịch vụ đang mở bán và thông tin giá cả. Xem chi tiết API.
Tạo Booking: Khi khách hàng chọn xong dịch vụ, gọi /api/v1/b2c/create-booking. Hệ thống sẽ giữ chỗ và trả về mã VietQR ứng với số tiền cần thanh toán. Xem chi tiết API.
Thanh toán: Khách hàng mở ứng dụng ngân hàng để quét mã QR. Sau khi giao dịch thành công, ngân hàng sẽ gửi tín hiệu thông qua Webhook về hệ thống.
Xuất vé: Ngay khi nhận được Webhook thanh toán hợp lệ, hệ thống sẽ tự động chuyển trạng thái booking sang TICKET_EXPORTED và xuất vé. Khách hàng có thể kiểm tra lại thông tin vé qua API lấy thông tin booking.

Ứng dụng B2C có thể gọi API để hủy một booking nháp nếu khách hàng chủ động thoát (cancel) hoặc yêu cầu hủy trước khi thanh toán.

Hủy booking: Gọi API /api/v1/cancel-booking với booking_id để hủy đơn hàng. Xem chi tiết API.

Lưu ý

Nếu khách hàng không thực hiện thanh toán trong vòng 60 phút, hệ thống sẽ tự động hủy booking và mã QR thanh toán sẽ không còn hiệu lực.
Trạng thái booking lúc này sẽ chuyển từ BOOKING sang BOOKING_TIMEOUT. :::