Đơn hàng

Quyền: orders:read.

GET /api/v1/orders

Tham số: offset, limit, family, status, client_reference (khớp chính xác).

Giá trị family hoặc status không xác định được hiểu là “không lọc”. Thứ tự cố định và không thể thay đổi: mới nhất ở trên.

Trường	Ý nghĩa
product, kind, family	đã mua gì; kind: resident hoặc ipv4
quantity	số đơn vị đã mua: số địa chỉ với ipv4; với đơn hàng lưu lượng luôn là 1 - đã mua một gói, còn dung lượng nằm trong packages[].traffic.purchased_gb
price_per_proxy, total	giá mỗi đơn vị (total / quantity) và giá trị đơn hàng; với đơn hàng lưu lượng hai giá trị này bằng nhau
status	xem bên dưới
applied_to_package_id	không rỗng - đơn hàng được áp dụng cho một gói hiện có: nạp thêm lưu lượng hoặc gia hạn địa chỉ
client_reference	nhãn của bạn từ nội dung yêu cầu mua
packages	gói lưu lượng mà đơn hàng đã cấp. Rỗng với đơn nạp thêm và đơn hàng địa chỉ cố định - đọc các gói đó qua GET /api/v1/packages?family=dedicated, thẻ gói có order_id

GET /api/v1/orders/{id}

Cấu trúc giống như trong danh sách. Đơn hàng của tài khoản khác trả về 404 không có khóa code.

Trạng thái cấp phát

Giao dịch mua hoàn tất ngay trong yêu cầu, vì vậy trong phản hồi của POST /api/v1/packages đơn hàng đã ở trạng thái completed. Các trạng thái khác xuất hiện khi đọc đơn hàng.

Trạng thái	Cần làm gì
pending, provisioning	truy vấn lại mỗi 5-10 giây
completed	hoàn tất: gói lưu lượng trong packages[0], gói địa chỉ - trong package_id của phản hồi mua
failed	tiền chưa bị trừ hoặc đã được hoàn, có thể thử lại
refunded	tiền đã được hoàn theo quyết định của bộ phận hỗ trợ; thử lại như một lần mua mới
needs_attention	tiền đã bị trừ, đang được xử lý thủ công. Không mua lại, hãy liên hệ bộ phận hỗ trợ

Thay vì truy vấn đơn hàng, bạn có thể đọc nhật ký sự kiện.