Tổng quan
Hệ thống Booking Engine là một API cho phép đối tác có thể tích hợp để thực hiện các chức năng đặt vé và quản lý đặt vé.
Tính năng chính
- Tạo đơn đặt vé (Create Booking)
- Xác nhận đơn đặt vé (Confirm Booking)
- Hủy đơn đặt vé (Cancel Booking)
- Tra cứu thông tin đơn đặt vé (Get Booking)
Base URL
https://dev.thinksoft.com.vn
Credentials
| Credential | Description |
|---|---|
| client_id | ID định danh duy nhất của đối tác |
| client_secret | Khóa bí mật dùng để ký request |
Required Headers
| Header | Type | Description |
|---|---|---|
| X-Client-Id | string | Client ID được cấp |
| X-Timestamp | number | Unix timestamp |
| X-Signature | string | Chữ ký HMAC-SHA256 của request |
| Content-Type | string | application/json |
ERROR CODE
| ERROR | CODE | Description |
|---|---|---|
| SUCCESS | 1000 | Thành công |
| REQUEST_ERROR | 1001 | Lỗi tham số |
| INVALID_SIGNATURE | 1002 | Sai chữ ký |
| CLIENT_ID_INVALID | 1003 | Client ID không hợp lệ |
| TIMESTAMP_INVALID | 1004 | Timestamp không hợp lệ |
| SIGNATURE_INVALID | 1005 | Chữ ký không hợp lệ |
| IP_ADDRESS_NOT_ALLOWED | 1006 | IP không trong whitelist |
| DATE_INVALID | 1007 | Ngày sai hoặc không đúng định dạng |
| BOOKING_NOT_FOUND | 1008 | Không tìm thấy booking |
| BOOKING_ALREADY_CONFIRMED | 1009 | Booking đã confirm trước đó |
| BOOKING_ALREADY_CANCELED | 1010 | Booking đã cancel |
| CUSTOMER_INVALID | 1011 | Thông tin khách hàng không đúng |
| PACKAGES_INVALID | 1012 | Thông tin package không đúng |
| TOO_MANY_REQUESTS | 1013 | Quá nhiều yêu cầu |
| PAYGATE_NOT_FOUND | 1014 | Không tìm thấy cổng thanh toán |
| INVALID_PARAMS | 1015 | Tham số không hợp lệ |
| DEBT_LIMIT_EXCEEDED | 1016 | Vượt quá hạn mức công nợ |
| DEBT_DAYS_EXCEEDED | 1017 | Vượt quá số ngày công nợ cho phép |
| DEBT_ACCOUNT_NOT_FOUND | 1018 | Không tìm thấy tài khoản công nợ |
| DEBT_ACCOUNT_NOT_ACTIVE | 1019 | Tài khoản công nợ không hoạt động |
| CUTOFF_TIME_LIMIT | 1020 | Hết thời gian đặt vé trong ngày |
| BOOKING_TIMEOUT | 1021 | Hết thời gian xử lý booking |