POST
/v1/order/@product_idĐặt mua một dịch vụ
Tạo đơn cho một gói theo product_id, cycle, domain (dạng cũ; nên dùng POST /v1/order). Cần cả orders:write và billing:write: thiếu một trong hai trả 403 insufficient_scope.
API v1 · Cập nhật 21/10/2026Xem .md
Gọi qua gateway https://api.tino.vn/v1 bằng token có quyền orders:write; xem Gọi API Tino.
Xác thực
Gửi token trong header Authorization:
Authorization: Bearer <token>
Token gọi được: token ứng dụng (tinoat_, Đăng nhập bằng Tino) hoặc token API cá nhân (tinopat_).
Scopes
orders:write
Tham số
Tham số đường dẫn
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
product_id | integer | Bắt buộc | ID sản phẩm (gói dịch vụ, chứng chỉ) |
Body (JSON)
| Tên | Kiểu | Yêu cầu | Mô tả |
|---|---|---|---|
domain | string | Tuỳ chọn | Domain name, ie. example.com, may be optional |
cycle | string | Tuỳ chọn | Billing period symbol |
pay_method | integer | Tuỳ chọn | Payment method ID |
custom | array | Tuỳ chọn | Additional options data available for sop products |
promocode | string | Tuỳ chọn | Promotion code |
aff_id | integer | Tuỳ chọn | Affiliate ID |
Phản hồi
Chưa có mẫu thật: route thay đổi dữ liệu thật hoặc tài khoản thử không có dữ liệu cho route này. Câu trả lời là một đối tượng JSON; lỗi theo dạng chung ở Gọi API Tino.
Mã lỗi
| Mã lỗi | Mô tả |
|---|---|
401 · invalid_token | Token sai, hết hạn hoặc đã bị thu hồi. |
403 · insufficient_scope | Token không có quyền orders:write. |
403 · ip_not_allowed | Token API cá nhân gọi từ IP ngoài danh sách giới hạn. |
Lỗi nghiệp vụ của route thường là HTTP 200 kèm {"error": ["<code>"]}; xem mã lỗi chung.