Tổng quan

ThinkBox -BE là hệ thống 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

• Danh mục:
  • Lấy danh sách gói bán (Sale Packages List)
• Booking:
  • 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 chi tiết một đơn đặt vé (Booking Info)
  • Lấy danh sách đơn đặt vé (Booking List)
• Công nợ:
  • Tra cứu thông tin hạn mức công nợ (Debt Info)

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