POST/v1/carts

Create a cart

Create a cart for the account (the token ties the cart to the account), optionally with items, vat_info, aff_id. Returns the cart uuid.

API v1 · Updated 2026-10-21View .md

Call it through the gateway https://api.tino.vn/v1 with a token that has the orders:write scope; see Calling the Tino API.

Authentication

Send the token in the header Authorization:

Authorization: Bearer <token>

Tokens that can call it: app tokens (tinoat_, Sign in with Tino) or personal API tokens (tinopat_).

Scopes

orders:write

Parameters

Body (JSON)

Name	Type	Required	Description
`items`	array	—	Món theo định dạng POST /quote (product; domain đăng ký/chuyển)

Response

No live sample: the route changes real data or the test account has no data for it. The answer is a JSON object; errors follow the common shape in Calling the Tino API.

Error codes

Error code	Description
`401 · invalid_token`	The token is wrong, expired or revoked.
`403 · insufficient_scope`	The token lacks the orders:write scope.
`403 · ip_not_allowed`	A personal API token called from an IP outside its allow-list.

Business errors of a route usually come as HTTP 200 with {"error": ["<code>"]}; see common error codes.