{
	"info": {
		"_postman_id": "911cdadd-b751-544e-84ea-ba917b1a0386",
		"name": "Cytrongift API v1.5.4",
		"description": "Browse the buy-back catalogue, sell gift cards and game keys, request payouts and manage your [Cytrongift](https://cytrongift.com/) account through a JSON API.\n\n## Base address\n\n`https://api.cytrongift.com/v1`. Add any endpoint path below to this URL. The same API with test money lives at `https://sandbox.cytrongift.com/v1`, see [Sandbox](#sandbox).\n\n## Envelope\n\nSuccessful requests return `{ \"ok\": 1, \"data\": { } }`. Errors return `{ \"ok\": 0, \"error\": { \"id\": \"3003\", \"code\": 401, \"desc\": \"\", \"advice\": \"\", \"extra\": { } } }`.\n\n`error.code` matches the HTTP status. `desc` explains what went wrong; `advice` tells you what to do next. Both follow `Accept-Language`; use `ru` for Russian. Error ids fall into three groups: 3xxx for authentication and limits, 4xxx for business rules, and 5xxx for transport and service errors.\n\n> [!NOTE] Handle errors by id\n> Use `error.id` in your code. The wording of `desc` and `advice` may change between releases, but the id stays the same.\n\n## Authentication\n\nStart in [Apps & API](https://cytrongift.com/en/account/apps/) in your Cytrongift account. Request access, wait for the approval email, then create a key. You get a public **Key ID** (`ck_...`) and a **Secret** (`cs_...`). The secret is shown only once.\n\nTo sign a request, send these three headers:\n\n```text\nX-Api-Key: ck_...\nX-Timestamp: 1788605154\nX-Signature: hex( hmac_sha256( METHOD + \"\\n\" + PATH + \"\\n\" + TIMESTAMP + \"\\n\" + RAW_BODY, secret ) )\n```\n\n- `PATH` is the endpoint path without `/v1` or the query string, for example `/account/balance`.\n- `TIMESTAMP` is Unix time in seconds. It must be within 300 seconds of the server clock, or you get `3002`.\n- `RAW_BODY` is the exact body you send, byte for byte. Use an empty string for `multipart/form-data`.\n\nYou can also call `POST /auth` with a signed request to get a Bearer token. Send it as `Authorization: Bearer ...` on endpoints that accept either authentication method. The token lasts up to a day and stays linked to the application that created it.\n\nA first-party application that signs its members in on its own server (a Telegram Mini App, for example) calls `POST /auth/identity` and receives a user token pair (`ut_...` and `rt_...`) for one member; every call with that token acts as that member and carries the application's scopes except `identity:assert`. A new member signs in with an e-mail address first: `POST /auth/identity` with `create: false`, then `POST /auth/identity/claim` mails a code and `POST /auth/identity/claim/confirm` turns it into the token pair. A member without a confirmed e-mail address can read everything, but `POST /sell/cards`, `POST /sell/games` and `POST /withdrawal/create` answer `403` with error `4086` until the address from `POST /account/email` is confirmed.\n\n> [!WARNING] Keep the secret on your backend\n> Save it when you create the key; you cannot view it again. Never put it in browser code or a mobile app bundle. Lost it? Rotate the key in [Apps & API](https://cytrongift.com/en/account/apps/). The old key keeps working for 24 hours, giving you time to update your integration.\n\nEach application has a set of approved **scopes**. Check the scope listed for the endpoint you want to call. Without it, the request returns `3014`. A paused or disabled application returns `3013`; a revoked or expired key returns `3012`.\n\n## Limits\n\nThe default limit is 60 requests per minute. An application can have a higher limit (a first-party application up to 6000); requests are counted per key, before authentication. A request with a user token also counts against that member's own limit of 60 a minute, and the `X-RateLimit-*` headers report whichever budget has fewer requests left. Exceed the limit and you get HTTP `429`, error `3011`, and a `Retry-After` header. Every answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (seconds left in the current minute), so a client can pace itself before the refusal.\n\n> [!TIP] Wait before retrying\n> Wait the number of seconds in `Retry-After` before trying again. Retrying in a tight loop will keep hitting the limit. Need a higher limit? Send support your application name.\n\nDuring maintenance, every endpoint except `/health` returns HTTP `503` with error `5008`.\n\n## Content types and pagination\n\nFor `POST` and `PATCH`, send `application/json`; an unsupported content type returns `4000`. The exception is `POST /uploads/images`, which takes `multipart/form-data`. `GET` requests need no `Content-Type`.\n\nList endpoints use cursor pagination: `?cursor=123&limit=20`. The response includes `items`, `limit`, `cursor`, `next_cursor` and `filters`. Use `next_cursor` for the next page; `null` means you have reached the end. Catalogue lists run from lower to higher ids. Account and withdrawal lists run from higher to lower ids.\n\n## Webhooks\n\nRegister up to 5 https addresses with `POST /account/webhooks`; the answer shows the `secret` once. Each finished sale or payout and each decision on your application is delivered as one JSON POST: `event` (`order.completed`, `order.rejected`, `withdrawal.completed`, `withdrawal.rejected`, `application.approved`, `application.rejected`, `application.paused`), `entity`, `id`, `status`, `amount` and `currency` for money events, `name` and `reason` for application events, `user_id` and `at`. The headers `X-Event` and `X-Delivery-Id` repeat the event and the delivery number; `X-Signature` is `hmac_sha256(body, secret)` in hex. Verify it before you act.\n\nAnswer `2xx` within 10 seconds. A `5xx`, a timeout or a connection failure is retried with growing delays, 5 attempts at most; a `410` switches the address off; any other `4xx` drops that delivery. Deliveries are at least once: keep the delivery id and skip one you have already handled.\n\n## Money\n\nAmounts use the site currency (USD), with up to two decimal places. Catalogue prices are different: each `price` uses the item's `currency_id`. To convert it to a payout in site currency, use `price / payments[currency_id].rate`.\n\n\n## Sandbox\n\n`https://sandbox.cytrongift.com/v1`. The same API against a separate database with test money: every path, envelope, signature rule and error id is the one above. Only the address and the key differ, so a client built here runs on the live address after a change of base URL and key pair.\n\n### Get access\n\n1. Open [Apps & API](https://cytrongift.com/en/account/apps/) in your Cytrongift account and request API access, exactly as for the live API. One approval covers both addresses.\n2. Once the application is approved, press **Sandbox key** on the same page. You get a Key ID that starts with `cks_` and a Secret (`cs_...`) shown once; the live key stays separate.\n3. Point your client at the sandbox address and sign requests the usual way. The example clients take the base URL as their first argument:\n\n```bash\nCYTRON_API_KEY=cks_... CYTRON_API_SECRET=cs_... php client.php https://sandbox.cytrongift.com/v1\n```\n\n4. Call `GET /health`: on the sandbox it reports `\"sandbox\": true`, and every sandbox answer carries the header `X-Sandbox: 1`.\n\n> [!WARNING] One key per address\n> A sandbox key on the live address, or a live key on the sandbox, answers `401` with error `3016`. Keep the two key pairs apart in your configuration and switch both together with the base URL.\n\n### What is different\n\n| Area | On the sandbox |\n|---|---|\n| Balance | Every account starts with **1000 USD** of test money. No money moves and nothing is reviewed by a person. |\n| Orders and payouts | Settled by the sandbox itself **two minutes** after creation: most complete, **every third is rejected**, so both outcomes can be rehearsed. |\n| Catalogue | Brands, platforms, cards, keys, payout methods and prices are a **daily copy** of the live ones; icons and other file links point at the live site. |\n| Account data | Members, orders and payouts of the live site are never there; the sandbox account is a twin with the same ID. |\n| Webhooks | The same deliveries as on the live API, signed the same way, with one more header: `X-Sandbox: 1`. |\n| Limits | **60 requests a minute**, not raised. Uploads, tokens and the rest of the account endpoints work as on the live address. |\n\n> [!TIP] Rehearse both outcomes\n> Create three orders, register a webhook address and wait two minutes: two orders complete and one is rejected, so your handler sees `order.completed` and `order.rejected` with the `X-Sandbox: 1` header before it ever meets live money.\n",
		"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
	},
	"item": [
		{
			"name": "Service",
			"description": "Check service health, read configuration and look up bonus tiers.",
			"item": [
				{
					"name": "Health check",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/health",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"health"
							]
						},
						"description": "Checks the database and cache. Returns `200` when both respond, or `503` if either check fails.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Health check",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/health",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"health"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"status\": \"ok\",\n\t\t\"service\": \"cytrongift-api\",\n\t\t\"version\": \"1.5.4\",\n\t\t\"sandbox\": false,\n\t\t\"timestamp\": 1788605154,\n\t\t\"checks\": {\n\t\t\t\"database\": \"ok\",\n\t\t\t\"cache\": \"ok\"\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Service configuration",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/config",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"config"
							]
						},
						"description": "Returns service metadata, the allowed values used by write endpoints, and public website links. The `links` object includes support, developer, blog and agreement URLs for each language. `links.news` repeats `links.blog` for clients built on the old name; it is removed in a later release.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Service configuration",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/config",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"config"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"service\": \"cytrongift-api\",\n\t\t\"version\": \"1.5.4\",\n\t\t\"currency_code\": \"USD\",\n\t\t\"currency_symbol\": \"$\",\n\t\t\"languages\": [\n\t\t\t\"en\",\n\t\t\t\"ru\"\n\t\t],\n\t\t\"card_types\": {\n\t\t\t\"ALL\": 0,\n\t\t\t\"ECODE\": 1,\n\t\t\t\"PCARD\": 2\n\t\t},\n\t\t\"order_status\": {\n\t\t\t\"PROCESSING\": 0,\n\t\t\t\"COMPLETE\": 1,\n\t\t\t\"REJECTED\": 2,\n\t\t\t\"UNDER_REVIEW\": 3\n\t\t},\n\t\t\"signature_window\": 300,\n\t\t\"rate_limit_minute\": 60,\n\t\t\"timestamp\": 1788605157,\n\t\t\"links\": {\n\t\t\t\"support\": \"https://cytrongift.com/en/support/\",\n\t\t\t\"developer\": \"https://api.cytrongift.com/docs/\",\n\t\t\t\"blog\": {\n\t\t\t\t\"en\": \"https://cytrongift.com/en/blog/\",\n\t\t\t\t\"ru\": \"https://cytrongift.com/ru/blog/\"\n\t\t\t},\n\t\t\t\"news\": {\n\t\t\t\t\"en\": \"https://cytrongift.com/en/blog/\",\n\t\t\t\t\"ru\": \"https://cytrongift.com/ru/blog/\"\n\t\t\t},\n\t\t\t\"agreement\": {\n\t\t\t\t\"en\": \"https://cytrongift.com/en/pages/terms.html\",\n\t\t\t\t\"ru\": \"https://cytrongift.com/ru/pages/terms.html\"\n\t\t\t}\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Bonus tiers",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/bonus",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"bonus"
							]
						},
						"description": "Returns the public table of bonus tiers.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Bonus tiers",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/bonus",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"bonus"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"levels\": [\n\t\t\t{\n\t\t\t\t\"level\": 1,\n\t\t\t\t\"threshold\": 10000,\n\t\t\t\t\"bonus_percent\": 0.05\n\t\t\t}\n\t\t]\n\t}\n}"
						}
					]
				},
				{
					"name": "Site statistics",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/stats",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"stats"
							]
						},
						"description": "Returns the public counters of the service, counted from the database and refreshed at most once an hour: `card_types` (the live cards and games a seller can choose now), `members` (confirmed accounts that may sign in), `items_sold` (the quantity of items in completed orders) and `referral_rewards` (the lifetime referral credits paid to members, a number in USD with two decimals), plus `currency` and `symbol`. No credentials are needed.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Site statistics",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/stats",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"stats"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"card_types\": 120,\n\t\t\"members\": 25000,\n\t\t\"items_sold\": 98000,\n\t\t\"referral_rewards\": 14250.5,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Latest sales",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/sales/latest",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"sales",
								"latest"
							]
						},
						"description": "Lists the 10 most recent completed sales, anonymous. Each item has `id` (an opaque hash), `kind` (`card` or `game`), `item_id`, `name_en`, `name_ru`, `amount` (a number in USD), `sold_at` (ISO 8601 UTC) and `has_image`; when `has_image` is true the logo is at `/catalog/images?kind=<kind>&id=<item_id>`. No credentials are needed.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Latest sales",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/sales/latest",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"sales",
										"latest"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": \"9f2c0e5d1b7a4c3e8d6f5a4b3c2d1e0f9a8b7c6d5e4f3a2b1c0d9e8f7a6b5c4d\",\n\t\t\t\t\"kind\": \"card\",\n\t\t\t\t\"item_id\": 42,\n\t\t\t\t\"name_en\": \"Apple Gift Card US\",\n\t\t\t\t\"name_ru\": \"Apple Gift Card US\",\n\t\t\t\t\"amount\": 48.5,\n\t\t\t\t\"sold_at\": \"2026-11-06T09:30:00Z\",\n\t\t\t\t\"has_image\": true\n\t\t\t}\n\t\t],\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\"\n\t}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Catalogue",
			"description": "Browse the cards and game keys we buy, plus the available payout methods. These endpoints are public.",
			"item": [
				{
					"name": "Brands",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/brands",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"brands"
							]
						},
						"description": "Lists brands with at least one gift card currently accepted for sale. Each item includes `id`, `name_ru`, `name_en`, `icon` and `sort`. The `icon` is an absolute URL, or an empty string if no icon is set.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Brands",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/brands",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"brands"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 1,\n\t\t\t\t\"name_ru\": \"Amazon\",\n\t\t\t\t\"name_en\": \"Amazon\",\n\t\t\t\t\"icon\": \"https://cytrongift.com/uploads/brands/amazon.svg\",\n\t\t\t\t\"sort\": 1\n\t\t\t}\n\t\t],\n\t\t\"total\": 1\n\t}\n}"
						}
					]
				},
				{
					"name": "Platforms",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/platforms",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"platforms"
							]
						},
						"description": "Lists platforms with at least one game currently accepted for sale. Each item includes `id`, `name_ru`, `name_en`, `icon`, `receipt_required` and `sort`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Platforms",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/platforms",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"platforms"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 1,\n\t\t\t\t\"name_ru\": \"Steam\",\n\t\t\t\t\"name_en\": \"Steam\",\n\t\t\t\t\"icon\": \"\",\n\t\t\t\t\"receipt_required\": false,\n\t\t\t\t\"sort\": 1\n\t\t\t}\n\t\t],\n\t\t\"total\": 1\n\t}\n}"
						}
					]
				},
				{
					"name": "Payout methods",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/payments",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"payments"
							]
						},
						"description": "Returns payout methods and the exchange rates used to calculate payouts. Each item includes `id`, `code`, `currency`, `network`, `name_ru`, `name_en`, `icon`, `example`, `rate`, `rate_date`, `round`, `needs_fio` and `sort`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Payout methods",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/payments",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"payments"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 2,\n\t\t\t\t\"code\": \"BTC\",\n\t\t\t\t\"currency\": \"BTC\",\n\t\t\t\t\"network\": \"\",\n\t\t\t\t\"name_ru\": \"Bitcoin\",\n\t\t\t\t\"name_en\": \"Bitcoin\",\n\t\t\t\t\"icon\": \"\",\n\t\t\t\t\"example\": \"1A1zP1...\",\n\t\t\t\t\"rate\": 79728.1,\n\t\t\t\t\"rate_date\": 1788605000,\n\t\t\t\t\"round\": 8,\n\t\t\t\t\"needs_fio\": false,\n\t\t\t\t\"sort\": 1\n\t\t\t}\n\t\t],\n\t\t\"total\": 1\n\t}\n}"
						}
					]
				},
				{
					"name": "Gift cards",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/cards?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"cards"
							],
							"query": [
								{
									"key": "brand_id",
									"value": "",
									"description": "Filter by brand id. (optional)",
									"disabled": true
								},
								{
									"key": "country_id",
									"value": "",
									"description": "Filter by country id. (optional)",
									"disabled": true
								},
								{
									"key": "search",
									"value": "",
									"description": "Match part of the item name. (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "Return items with ids greater than this cursor. (optional)",
									"disabled": true
								},
								{
									"key": "limit",
									"value": "50",
									"description": "Items per page: 1 to 500. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Returns a paginated list of gift cards. Each item includes `id`, `name_ru`, `name_en`, `icon`, `price`, `currency_id`, `country_id`, `brand_id` and `sort`. The `price` is in the currency identified by `currency_id`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Gift cards",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/cards?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"cards"
									],
									"query": [
										{
											"key": "brand_id",
											"value": "",
											"description": "Filter by brand id. (optional)",
											"disabled": true
										},
										{
											"key": "country_id",
											"value": "",
											"description": "Filter by country id. (optional)",
											"disabled": true
										},
										{
											"key": "search",
											"value": "",
											"description": "Match part of the item name. (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "Return items with ids greater than this cursor. (optional)",
											"disabled": true
										},
										{
											"key": "limit",
											"value": "50",
											"description": "Items per page: 1 to 500. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 1,\n\t\t\t\t\"name_ru\": \"Amazon 100 USD\",\n\t\t\t\t\"name_en\": \"Amazon 100 USD\",\n\t\t\t\t\"icon\": \"\",\n\t\t\t\t\"price\": 85,\n\t\t\t\t\"currency_id\": 1,\n\t\t\t\t\"country_id\": 9,\n\t\t\t\t\"brand_id\": 1,\n\t\t\t\t\"sort\": 0\n\t\t\t}\n\t\t],\n\t\t\"limit\": 50,\n\t\t\"cursor\": 0,\n\t\t\"next_cursor\": null,\n\t\t\"filters\": {\n\t\t\t\"brand_id\": null,\n\t\t\t\"country_id\": null,\n\t\t\t\"search\": \"\"\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Game keys",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/games?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"games"
							],
							"query": [
								{
									"key": "platform_id",
									"value": "",
									"description": "Filter by platform id. (optional)",
									"disabled": true
								},
								{
									"key": "country_id",
									"value": "",
									"description": "Filter by country id. (optional)",
									"disabled": true
								},
								{
									"key": "search",
									"value": "",
									"description": "Match part of the item name. (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "Return items with ids greater than this cursor. (optional)",
									"disabled": true
								},
								{
									"key": "limit",
									"value": "50",
									"description": "Items per page: 1 to 500. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Returns a paginated list of game keys. Items have the same fields as gift cards, with `platform_id` instead of `brand_id`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Game keys",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/games?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"games"
									],
									"query": [
										{
											"key": "platform_id",
											"value": "",
											"description": "Filter by platform id. (optional)",
											"disabled": true
										},
										{
											"key": "country_id",
											"value": "",
											"description": "Filter by country id. (optional)",
											"disabled": true
										},
										{
											"key": "search",
											"value": "",
											"description": "Match part of the item name. (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "Return items with ids greater than this cursor. (optional)",
											"disabled": true
										},
										{
											"key": "limit",
											"value": "50",
											"description": "Items per page: 1 to 500. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [],\n\t\t\"limit\": 50,\n\t\t\"cursor\": 0,\n\t\t\"next_cursor\": null,\n\t\t\"filters\": {}\n\t}\n}"
						}
					]
				},
				{
					"name": "Countries by brand or platform",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/countries?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"countries"
							],
							"query": [
								{
									"key": "brand_id",
									"value": "",
									"description": "Brand id. (optional)",
									"disabled": true
								},
								{
									"key": "platform_id",
									"value": "",
									"description": "Platform id. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Pass either `platform_id` or `brand_id`; omitting both returns `4012`. If you send both, `platform_id` takes priority.\n\nEach item includes `country_id`, `title` in the requested language, `code` (a lowercase ISO 3166-1 alpha-2 code) and `flag`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Countries by brand or platform",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/countries?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"countries"
									],
									"query": [
										{
											"key": "brand_id",
											"value": "",
											"description": "Brand id. (optional)",
											"disabled": true
										},
										{
											"key": "platform_id",
											"value": "",
											"description": "Platform id. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"country_id\": 9,\n\t\t\t\t\"title\": \"USA\",\n\t\t\t\t\"code\": \"us\",\n\t\t\t\t\"flag\": \"/templates/frontend/cytron/images/flags/us.svg\"\n\t\t\t}\n\t\t],\n\t\t\"total\": 1,\n\t\t\"filters\": {\n\t\t\t\"brand_id\": 1\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Offers",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/offers?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"offers"
							],
							"query": [
								{
									"key": "offset",
									"value": "0",
									"description": "Rows to skip, default 0. (optional)",
									"disabled": true
								},
								{
									"key": "limit",
									"value": "10",
									"description": "Page size from 1 to 100, default 10. (optional)",
									"disabled": true
								},
								{
									"key": "search",
									"value": "",
									"description": "Part of the English or Russian name, up to 100 characters. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Lists the gift cards currently accepted for sale, priced in USD, in the order the website shows them. Each item has `id` (the card id), `category_id` (the brand), `country_id`, `name_en`, `name_ru`, `amount` (a number) and `has_image`. Page with `next_offset`; it is null on the last page. An invalid `offset`, `limit` or `search` gives `4012`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Offers",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/offers?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"offers"
									],
									"query": [
										{
											"key": "offset",
											"value": "0",
											"description": "Rows to skip, default 0. (optional)",
											"disabled": true
										},
										{
											"key": "limit",
											"value": "10",
											"description": "Page size from 1 to 100, default 10. (optional)",
											"disabled": true
										},
										{
											"key": "search",
											"value": "",
											"description": "Part of the English or Russian name, up to 100 characters. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 42,\n\t\t\t\t\"category_id\": 3,\n\t\t\t\t\"country_id\": 10,\n\t\t\t\t\"name_en\": \"Apple Gift Card US\",\n\t\t\t\t\"name_ru\": \"Apple Gift Card US\",\n\t\t\t\t\"amount\": 8.08,\n\t\t\t\t\"has_image\": true\n\t\t\t}\n\t\t],\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\",\n\t\t\"next_offset\": 10\n\t}\n}"
						}
					]
				},
				{
					"name": "Catalogue image",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/catalog/images?kind=&id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"catalog",
								"images"
							],
							"query": [
								{
									"key": "kind",
									"value": "",
									"description": "What the id refers to.",
									"disabled": false
								},
								{
									"key": "id",
									"value": "",
									"description": "The id of the item.",
									"disabled": false
								}
							]
						},
						"description": "Streams a public catalogue image (a brand, platform, card or game logo, a country flag or a payment method icon) with its own content type and cache headers. A card or game logo is served as long as the item is not deleted, even after it left the sale; a brand, platform, country or payment icon needs an active row. An unknown or deleted item, or a kind without a logo, gives `4007`; a malformed id or kind gives `4012`.\n\nPublic: no authentication."
					},
					"response": [
						{
							"name": "200 Catalogue image",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/catalog/images?kind=&id=",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"catalog",
										"images"
									],
									"query": [
										{
											"key": "kind",
											"value": "",
											"description": "What the id refers to.",
											"disabled": false
										},
										{
											"key": "id",
											"value": "",
											"description": "The id of the item.",
											"disabled": false
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Auth",
			"description": "Create, refresh and revoke tokens for API access.",
			"item": [
				{
					"name": "Get a bearer token",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth"
							]
						},
						"description": "Sign this request with your application key. An existing token cannot be used to create another one.\n\nThe token stays linked to the application that signed the request. `ttl` is limited to 300 through 86400 seconds; if omitted, the site default applies.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature).",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"ttl\": 3600\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Get a bearer token",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"token_type\": \"Bearer\",\n\t\t\"access_token\": \"eyJ...\",\n\t\t\"expires_in\": 3600,\n\t\t\"expires_at\": 1788608789,\n\t\t\"merchant_id\": 8269\n\t}\n}"
						}
					],
					"event": [
						{
							"listen": "test",
							"script": {
								"type": "text/javascript",
								"exec": [
									"// Keeps the bearer token for the requests that accept it: add \"Authorization: Bearer {{bearer_token}}\" to use it.",
									"var json = pm.response.json();",
									"if (json && json.ok === 1 && json.data && json.data.access_token) {",
									"\tpm.collectionVariables.set('bearer_token', json.data.access_token);",
									"}"
								]
							}
						}
					]
				},
				{
					"name": "Get tokens for a verified user",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth/identity",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth",
								"identity"
							]
						},
						"description": "For first-party applications only: kind `first_party`, scope `identity:assert`. Sign the request with the application key.\n\nBefore calling this endpoint, verify the provider's credentials on your own server: for example, Telegram `initData` with the bot token, or a Discord OAuth code. The API looks up the account by `provider` and `provider_uid`. If none exists, it creates one from `profile` (`first_name`, `last_name`, `username`, `photo_url`, `language_code`).\n\nA new account gets its inviter from `start_param` (up to 64 characters, the Telegram launch parameter as the user opened it): `ref_<id>` names the inviting account by id, bare digits name an account created before the referral codes, any other value is read as a referral code. When `start_param` names nobody, `referral_code` is tried. Both apply only to an account this call creates; an existing account keeps its inviter.\n\nThe response contains an opaque token pair for the user and the account's mailbox state: `user.email` (empty for an account born from a provider) and `user.email_verified`. You can pass a `device` label of up to 64 characters. `ttl` is limited to 300 through 86400 seconds for the access token. The token inherits the application's scopes except `identity:assert`.\n\nIf the Telegram id is still linked to a legacy account, you get `4084` with `link_required`. The user needs to link that account on the website first.\n\nSend `create: false` to look the identity up without registering anyone: an unknown identity answers `404` with error `4146` and `reason: identity_unknown`, and nothing is created. This is the first step of the e-mail first sign-in, see `POST /auth/identity/claim`. `client_ip` (optional) is the visitor's address as your server saw it; a new account counts against the per-address sign-up limit with it instead of your server's address. An invalid address answers `4082` with `field: client_ip`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature).\nScope: `identity:assert`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"provider\": \"telegram\",\n\t\"provider_uid\": \"123456789\",\n\t\"profile\": {\n\t\t\"first_name\": \"Ada\",\n\t\t\"last_name\": \"\",\n\t\t\"username\": \"ada\",\n\t\t\"photo_url\": \"\",\n\t\t\"language_code\": \"ru\"\n\t},\n\t\"start_param\": \"ref_8607\",\n\t\"referral_code\": \"ada7\",\n\t\"create\": true,\n\t\"client_ip\": \"198.51.100.7\",\n\t\"device\": \"Mini App iPhone\",\n\t\"ttl\": 3600\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Get tokens for a verified user",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth/identity",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth",
										"identity"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"token_type\": \"Bearer\",\n\t\t\"access_token\": \"ut_...\",\n\t\t\"expires_in\": 3600,\n\t\t\"expires_at\": 1788608789,\n\t\t\"refresh_token\": \"rt_...\",\n\t\t\"refresh_expires_at\": 1791197189,\n\t\t\"scopes\": [\n\t\t\t\"catalog:read\",\n\t\t\t\"account:read\",\n\t\t\t\"orders:read\",\n\t\t\t\"orders:write\"\n\t\t],\n\t\t\"user\": {\n\t\t\t\"id\": 9001,\n\t\t\t\"login\": \"ada\",\n\t\t\t\"ref_code\": \"ada7\",\n\t\t\t\"email\": \"\",\n\t\t\t\"email_verified\": false,\n\t\t\t\"created\": true\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Mail a sign-in code to an address",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth/identity/claim",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth",
								"identity",
								"claim"
							]
						},
						"description": "For first-party applications only: kind `first_party`, scope `identity:assert`. Sign the request with the application key.\n\nThe e-mail first sign-in of a member whose identity has no account yet (`POST /auth/identity` with `create: false` answered `4146`), or whose account has no confirmed address. Verify the provider's credentials on your server first, exactly as for `POST /auth/identity`.\n\nThe API mails a six-digit code to `email` and keeps only its hash. The code works for 15 minutes, once, and only for the same `provider` and `provider_uid`; a new claim replaces the previous one. When you pass `confirm_link`, a Telegram Mini App link ending in `?startapp=` (`https://t.me/<bot>/<app>?startapp=` or `https://t.me/<bot>?startapp=`), the mail also carries an **Open in Telegram** button: the link with `c_<token>` appended, which reopens your app. Read the token from the launch parameter and confirm with it.\n\nThe answer, the mail and the work done are the same whether or not an account with this address exists, is blocked or already holds another Telegram, so the call cannot be used to find out who is registered. `retry_after` is the number of seconds before this identity may ask for another mail; `expires_in` is the life of the code.\n\nSend `client_ip`, the visitor's address as your server saw it: the limits count it. Limits: one mail a minute and five an hour per identity, three an hour per address, ten claims an hour per visitor address; a hit answers `429` with error `4088`, `reason: claim_wait`, `retry_after` and a `Retry-After` header. After ten wrong codes within a day the identity is locked: `429`, error `4147`, `reason: claim_locked`. A malformed address answers `4059` with `reason: email_invalid`, a throwaway mail domain `4059` with `reason: email_blocked`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature).\nScope: `identity:assert`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"provider\": \"telegram\",\n\t\"provider_uid\": \"123456789\",\n\t\"profile\": {\n\t\t\"first_name\": \"Ada\",\n\t\t\"last_name\": \"\",\n\t\t\"username\": \"ada\",\n\t\t\"photo_url\": \"\",\n\t\t\"language_code\": \"ru\"\n\t},\n\t\"email\": \"ada@example.com\",\n\t\"lang\": \"ru\",\n\t\"start_param\": \"ref_8607\",\n\t\"device\": \"Mini App iPhone\",\n\t\"client_ip\": \"198.51.100.7\",\n\t\"confirm_link\": \"https://t.me/cytrongift_bot/app?startapp=\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Mail a sign-in code to an address",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth/identity/claim",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth",
										"identity",
										"claim"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"sent\": true,\n\t\t\"retry_after\": 60,\n\t\t\"expires_in\": 900\n\t}\n}"
						}
					]
				},
				{
					"name": "Confirm a sign-in code and get tokens",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth/identity/claim/confirm",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth",
								"identity",
								"claim",
								"confirm"
							]
						},
						"description": "For first-party applications only: kind `first_party`, scope `identity:assert`. Sign the request with the application key.\n\nSend the same `provider` and `provider_uid` that asked for the code and exactly one proof: `code`, the six digits as a string, or `token`, the 32 characters after `c_` in the launch parameter the mail button opened your app with. A proof only opens the claim of the identity that made it: the code of another identity never matches.\n\nThe answer is the body of `POST /auth/identity` (a token pair and `user`) plus `outcome` and `email`, the confirmed address:\n\n- `created`: no account had this address; a new one exists now with the address confirmed and the identity attached, and the inviter from the claim's `start_param` is applied.\n- `linked`: an account with this address existed; the identity is attached to it and the owner gets a notice mail. If the identity belonged to an account born in your app, that account is archived when empty or merged when the account link would merge it by itself; otherwise `4142` and an operator decides. An account of another identity that only wrote the address without confirming it loses the address and does not count. If the account had never confirmed the address, its password, website sessions and tokens are cleared first, so whoever registered the address without owning the mailbox loses access.\n- `updated`: the identity's own account had no confirmed address and nobody else holds this one; the address is set on it, confirmed.\n\n**Two-factor authentication.** When the account that will hold the identity (`linked`, or the identity's own account on `updated`) has two-factor authentication on, the proven code or token is not enough: the call answers `403` `4150` `totp_required`. Nothing is attached, the claim stays live and no attempt is counted, so ask the member for the six digits of their authenticator app and send the same `code` again together with `totp` (six digits as a string). After a refused `token` send the mailed `code` with `totp`; the token works as well while the claim lives. A wrong `totp` answers `400` `4151` `totp_invalid` and counts as one wrong proof of the claim and of the day. While the account's second factor is locked after wrong codes the confirm answers `429` `4156` `totp_locked` with `retry_after`; the claim keeps its attempts and the same proof works once the lock has passed, if the code still lives. `created` never asks, and an account that never confirmed its address is not asked either: its password and its authenticator are cleared with it. A staff account stays closed (`4102`) unless the installation lists the Telegram id and the account has two-factor on, so this step always runs for it.\n\nRefusals carry `reason`: a wrong proof `400` `4148` `code_invalid` (nothing about the attempts left; five wrong proofs end the claim); no live claim (expired, used, ended by wrong proofs, replaced or never made) `410` `4149` `claim_expired`; ten wrong proofs within a day `429` `4147` `claim_locked` with `retry_after`; the account that confirmed the address already holds another identity of this provider, or the identity is on an account with another confirmed address, `409` `4140` `claim_conflict`; the account may not sign in (blocked, deleted, a staff account) `403` `4102` `claim_refused`; the Telegram id sits on a legacy account `409` `4084` `link_required`; a merge that needs an operator `409` `4142` `link_manual_review`; another sign-in of the same identity is running `503` `4145` `identity_busy`; too many new accounts from the visitor's address `429` `3011` `registration_throttled`. A conflict, a refusal, `link_required` and a review spend the claim; after `3011` or `4145` the same proof may be sent again while the code lives.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature).\nScope: `identity:assert`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"provider\": \"telegram\",\n\t\"provider_uid\": \"123456789\",\n\t\"code\": \"042137\",\n\t\"totp\": \"918273\",\n\t\"device\": \"Mini App iPhone\",\n\t\"client_ip\": \"198.51.100.7\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Confirm a sign-in code and get tokens",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth/identity/claim/confirm",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth",
										"identity",
										"claim",
										"confirm"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"token_type\": \"Bearer\",\n\t\t\"access_token\": \"ut_...\",\n\t\t\"expires_in\": 3600,\n\t\t\"expires_at\": 1788608789,\n\t\t\"refresh_token\": \"rt_...\",\n\t\t\"refresh_expires_at\": 1791197189,\n\t\t\"scopes\": [\n\t\t\t\"catalog:read\",\n\t\t\t\"account:read\",\n\t\t\t\"orders:read\",\n\t\t\t\"orders:write\"\n\t\t],\n\t\t\"user\": {\n\t\t\t\"id\": 9001,\n\t\t\t\"login\": \"ada\",\n\t\t\t\"ref_code\": \"ada7\",\n\t\t\t\"email\": \"ada@example.com\",\n\t\t\t\"email_verified\": true,\n\t\t\t\"created\": false\n\t\t},\n\t\t\"outcome\": \"linked\",\n\t\t\"email\": \"ada@example.com\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Refresh user tokens",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth/refresh",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth",
								"refresh"
							]
						},
						"description": "Exchanges a refresh token for a new token pair. Each refresh token works once; the old pair becomes invalid as soon as the new one is issued. A reused or revoked refresh token returns `3009`; an expired one returns `3008`.\n\nPublic: no authentication.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"refresh_token\": \"rt_...\",\n\t\"ttl\": 3600\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Refresh user tokens",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth/refresh",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth",
										"refresh"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"token_type\": \"Bearer\",\n\t\t\"access_token\": \"ut_...\",\n\t\t\"expires_in\": 3600,\n\t\t\"expires_at\": 1788608789,\n\t\t\"refresh_token\": \"rt_...\",\n\t\t\"refresh_expires_at\": 1791197189,\n\t\t\"scopes\": [\n\t\t\t\"catalog:read\",\n\t\t\t\"account:read\",\n\t\t\t\"orders:read\",\n\t\t\t\"orders:write\"\n\t\t]\n\t}\n}"
						}
					]
				},
				{
					"name": "Revoke a user token",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/auth/logout",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"auth",
								"logout"
							]
						},
						"description": "Immediately revokes the opaque user token used for this request. JWTs cannot be revoked through this endpoint and return `4082`.\n\nAuthentication: Bearer token.",
						"body": {
							"mode": "raw",
							"raw": "{}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Revoke a user token",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/auth/logout",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"auth",
										"logout"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"revoked\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Start linking Telegram to a site account",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/start",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"start"
							]
						},
						"description": "For first-party applications: scope `identity:link`, called with the user's token (or the application key for its own account). Opens a challenge for the Telegram identity the acting user holds. The body is `{}` or `{\"purpose\": \"link\"}` for a link, `{\"purpose\": \"assessment\"}` for a report only.\n\nKeep `id` and `secret` on your server: they are the proof for `status`, `cancel`, `assessment` and `complete`. Show `website_url` to the user; the site page asks the signed-in owner of the site account to approve. The challenge lives `expires_in` seconds (600); a new start cancels the open one.\n\nAn account that is already a site account, or a Telegram id already linked, returns `4140` with `already_linked`. A user without a Telegram identity gets `4144`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `identity:link`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"purpose\": \"link\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Start linking Telegram to a site account",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/start",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"start"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"purpose\": \"link\",\n\t\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\t\"secret\": \"9f2c...64 hex characters\",\n\t\t\"website_url\": \"https://cytrongift.com/en/account/link/#4cfd03147dc461f0a41324ac5cce8fef.5be1...\",\n\t\t\"expires_in\": 600,\n\t\t\"provider\": \"telegram\",\n\t\t\"provider_uid\": \"123456789\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Link status",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/status",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"status"
							]
						},
						"description": "No credentials: the proof `id` and `secret` from `/identities/link/start` is the authorisation. `status` is `pending` until the site owner approves, then `approved` with the site `account`; `completed` after `/identities/link/complete`; `review` when the link waits for an operator (see `4142`). A wrong, cancelled or expired proof returns `4143`.\n\nPublic: no authentication.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\"secret\": \"9f2c...64 hex characters\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Link status",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/status",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"status"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"purpose\": \"link\",\n\t\t\"status\": \"approved\",\n\t\t\"account\": {\n\t\t\t\"id\": \"8269\",\n\t\t\t\"display_name\": \"Ada Lovelace\"\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Cancel a link",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/cancel",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"cancel"
							]
						},
						"description": "No credentials: the proof `id` and `secret` is the authorisation. Closes an open challenge; `cancelled` is false for one already completed. A wrong, cancelled or expired proof returns `4143`.\n\nPublic: no authentication.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\"secret\": \"9f2c...64 hex characters\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Cancel a link",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/cancel",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"cancel"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"cancelled\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "What completing a link would do",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/assessment",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"assessment"
							]
						},
						"description": "No credentials: the proof `id` and `secret` of an approved challenge, of either purpose. Reports what stands between the Telegram account (`source`) and the site account (`target`): balances, history counts, `outcome` (`no_obstacles`, `manual_review` or `blocked`) and `reasons`. Nothing changes; `execution_available` is always false.\n\n`complete_available` says whether `/identities/link/complete` would go through by itself: the source is empty, or the outcome is `no_obstacles` and `balance_moved` (both source balances, USD) is at most `auto_merge_max` (100). Otherwise completion returns `4142`. A challenge not approved yet returns `4140` with `link_not_approved`.\n\nPublic: no authentication.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\"secret\": \"9f2c...64 hex characters\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 What completing a link would do",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/assessment",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"assessment"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"checked_at\": 1793965869,\n\t\t\"execution_available\": false,\n\t\t\"outcome\": \"no_obstacles\",\n\t\t\"source\": {\n\t\t\t\"id\": \"9001\",\n\t\t\t\"display_name\": \"Ada\",\n\t\t\t\"balances\": {\n\t\t\t\t\"main\": 20,\n\t\t\t\t\"referral\": 0\n\t\t\t},\n\t\t\t\"counts\": {\n\t\t\t\t\"orders\": 0,\n\t\t\t\t\"active_orders\": 0,\n\t\t\t\t\"withdrawals\": 0,\n\t\t\t\t\"active_withdrawals\": 0,\n\t\t\t\t\"referral_credits\": 0,\n\t\t\t\t\"invited\": 0,\n\t\t\t\t\"referred_orders\": 0,\n\t\t\t\t\"tickets\": 0,\n\t\t\t\t\"reviews\": 0,\n\t\t\t\t\"sale_receipts\": 0,\n\t\t\t\t\"withdrawal_receipts\": 0\n\t\t\t}\n\t\t},\n\t\t\"target\": {\n\t\t\t\"id\": \"8269\",\n\t\t\t\"display_name\": \"Ada Lovelace\",\n\t\t\t\"balances\": {\n\t\t\t\t\"main\": 5,\n\t\t\t\t\"referral\": 0\n\t\t\t},\n\t\t\t\"counts\": {\n\t\t\t\t\"orders\": 0,\n\t\t\t\t\"active_orders\": 0,\n\t\t\t\t\"withdrawals\": 0,\n\t\t\t\t\"active_withdrawals\": 0,\n\t\t\t\t\"referral_credits\": 0,\n\t\t\t\t\"invited\": 0,\n\t\t\t\t\"referred_orders\": 0,\n\t\t\t\t\"tickets\": 0,\n\t\t\t\t\"reviews\": 0,\n\t\t\t\t\"sale_receipts\": 0,\n\t\t\t\t\"withdrawal_receipts\": 0\n\t\t\t}\n\t\t},\n\t\t\"combined_balances\": {\n\t\t\t\"main\": 25,\n\t\t\t\"referral\": 0\n\t\t},\n\t\t\"reasons\": [],\n\t\t\"complete_available\": true,\n\t\t\"balance_moved\": 20,\n\t\t\"auto_merge_max\": 100\n\t}\n}"
						}
					]
				},
				{
					"name": "Complete a link and get tokens for the site account",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/complete",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"complete"
							]
						},
						"description": "For first-party applications only: scope `identity:link`, signed with the application key. The body is the proof `id` and `secret` of an approved `link` challenge, with an optional `device` label and `ttl` as in `/auth/identity`.\n\nThe Telegram identity moves onto the site account. A Telegram account with nothing on it is archived. One with history or money is merged into the site account (balances, orders, withdrawals, referrals, tickets) only when the assessment found no obstacles and at most 100 USD moves; otherwise the call returns `4142` with the `outcome`, `reasons` and `balance_moved` in `extra`, nothing changes, and the challenge stays for an operator with status `review`.\n\nThe answer has the shape of `/auth/identity` for the site account, with `user.created` false; the tokens of the Telegram account stop working. Repeating the call after a lost answer issues a fresh pair without moving anything again. A challenge not approved, or a site session that ended before completion, returns `4140`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature).\nScope: `identity:link`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\"secret\": \"9f2c...64 hex characters\",\n\t\"device\": \"Mini App iPhone\",\n\t\"ttl\": 3600\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Complete a link and get tokens for the site account",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/complete",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"complete"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"token_type\": \"Bearer\",\n\t\t\"access_token\": \"ut_...\",\n\t\t\"expires_in\": 3600,\n\t\t\"expires_at\": 1793969468,\n\t\t\"refresh_token\": \"rt_...\",\n\t\t\"refresh_expires_at\": 1796557868,\n\t\t\"scopes\": [\n\t\t\t\"catalog:read\",\n\t\t\t\"account:read\",\n\t\t\t\"orders:read\",\n\t\t\t\"orders:write\",\n\t\t\t\"profile:write\",\n\t\t\t\"support:write\",\n\t\t\t\"identity:link\",\n\t\t\t\"notifications:manage\"\n\t\t],\n\t\t\"user\": {\n\t\t\t\"id\": 8269,\n\t\t\t\"login\": \"ada\",\n\t\t\t\"ref_code\": \"ada7\",\n\t\t\t\"email\": \"ada@example.com\",\n\t\t\t\"email_verified\": true,\n\t\t\t\"created\": false\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Approve a link on the website",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/identities/link/website",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"identities",
								"link",
								"website"
							]
						},
						"description": "Called by the site page `/<lang>/account/link/` on the site address, not by applications: it carries the site session cookie and the `X-CSRF-Token` header. The body is the website half of the proof from the hash of `website_url` and `approve`: `false` only reads the pair, `true` approves it for the signed-in account.\n\nWithout a signed-in site session the call returns `4140` with `website_session_required`; a challenge another account has taken returns `4140` with `link_conflict`; an expired one `4143`.\n\nPublic: no authentication.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": \"4cfd03147dc461f0a41324ac5cce8fef\",\n\t\"secret\": \"5be1...64 hex characters\",\n\t\"approve\": true\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Approve a link on the website",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/identities/link/website",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"identities",
										"link",
										"website"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"purpose\": \"link\",\n\t\t\"status\": \"approved\",\n\t\t\"account\": {\n\t\t\t\"id\": \"8269\",\n\t\t\t\"display_name\": \"Ada Lovelace\"\n\t\t},\n\t\t\"telegram\": {\n\t\t\t\"id\": \"123456789\",\n\t\t\t\"display_name\": \"Ada\"\n\t\t}\n\t}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Account",
			"description": "Read your balance, orders and bonus level, update your profile, manage webhooks.",
			"item": [
				{
					"name": "Balance",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/balance",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"balance"
							]
						},
						"description": "Returns your current account balance, read directly from the account record.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Balance",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/balance",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"balance"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"balance\": 250,\n\t\t\"referrals_earned\": 0,\n\t\t\"referrals_count\": 0,\n\t\t\"currency_code\": \"USD\",\n\t\t\"currency_symbol\": \"$\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Bonus level",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/bonus",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"bonus"
							]
						},
						"description": "Returns your bonus level based on completed payouts. `next_level` is `null` if you have reached the highest tier.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Bonus level",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/bonus",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"bonus"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"user\": {\n\t\t\t\"id\": 8269,\n\t\t\t\"login\": \"seller\",\n\t\t\t\"fullname\": \"\",\n\t\t\t\"email\": \"s@example.com\"\n\t\t},\n\t\t\"current\": {\n\t\t\t\"level\": 0,\n\t\t\t\"bonus_percent\": 0,\n\t\t\t\"unlock_amount\": 10000,\n\t\t\t\"progress_to_next\": 0,\n\t\t\t\"next_level\": 1\n\t\t},\n\t\t\"levels\": [\n\t\t\t{\n\t\t\t\t\"level\": 1,\n\t\t\t\t\"threshold\": 10000,\n\t\t\t\t\"bonus_percent\": 0.05\n\t\t\t}\n\t\t]\n\t}\n}"
						}
					]
				},
				{
					"name": "Order totals",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/analytics",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"analytics"
							]
						},
						"description": "Returns order totals grouped by status. `processing` includes statuses 0 and 3.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Order totals",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/analytics",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"analytics"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"complete\": {\n\t\t\t\"amount\": 0,\n\t\t\t\"quantity\": 0,\n\t\t\t\"orders\": 0\n\t\t},\n\t\t\"processing\": {\n\t\t\t\"amount\": 0,\n\t\t\t\"quantity\": 0,\n\t\t\t\"orders\": 0\n\t\t},\n\t\t\"rejected\": {\n\t\t\t\"amount\": 0,\n\t\t\t\"quantity\": 0,\n\t\t\t\"orders\": 0\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Orders",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/transactions?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"transactions"
							],
							"query": [
								{
									"key": "id",
									"value": "",
									"description": "Return one order directly in `data`, without the list wrapper. (optional)",
									"disabled": true
								},
								{
									"key": "type",
									"value": "",
									"description": "`cards` or `games` (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "Return items with ids less than this cursor. (optional)",
									"disabled": true
								},
								{
									"key": "limit",
									"value": "20",
									"description": "Items per page: 1 to 200. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Returns your orders, newest first. Pass `id` to fetch a single order directly in `data`, without the list wrapper. If the order does not belong to your account, you get `4007`.\n\nEach item includes `id`, `uuid`, `type`, `status` (`processing|complete|rejected|under_review`), `status_id`, `gift_id`, `brand_id`, `country_id`, `item`, `amount`, `total`, `net_total`, `quantity`, `cards_type`, `cards_list`, `user_images`, `receipt_images`, `user_comment`, `admin_comment`, `date_create`, `date_created` and `date_complete`.\n\nEach image entry includes a `url` pointing to `GET /account/order-image`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:read`."
					},
					"response": [
						{
							"name": "200 Orders",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/transactions?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"transactions"
									],
									"query": [
										{
											"key": "id",
											"value": "",
											"description": "Return one order directly in `data`, without the list wrapper. (optional)",
											"disabled": true
										},
										{
											"key": "type",
											"value": "",
											"description": "`cards` or `games` (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "Return items with ids less than this cursor. (optional)",
											"disabled": true
										},
										{
											"key": "limit",
											"value": "20",
											"description": "Items per page: 1 to 200. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [],\n\t\t\"limit\": 20,\n\t\t\"cursor\": 0,\n\t\t\"next_cursor\": null,\n\t\t\"filters\": {\n\t\t\t\"type\": null\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Order image",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/order-image?token=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"order-image"
							],
							"query": [
								{
									"key": "token",
									"value": "",
									"description": "The token from the image URL.",
									"disabled": false
								}
							]
						},
						"description": "Streams an order image as `image/webp` with `Cache-Control: private, no-store`. Use the `token` from the image's `url`; no other image identifier is needed. If it does not identify an image in your account, you get `4007`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:read`."
					},
					"response": [
						{
							"name": "200 Order image",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/order-image?token=",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"order-image"
									],
									"query": [
										{
											"key": "token",
											"value": "",
											"description": "The token from the image URL.",
											"disabled": false
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {}\n}"
						}
					]
				},
				{
					"name": "Profile settings",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/settings",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"settings"
							]
						},
						"description": "Returns your profile fields.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Profile settings",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/settings",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"settings"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 8269,\n\t\t\"login\": \"seller\",\n\t\t\"email\": \"s@example.com\",\n\t\t\"email_verified\": false,\n\t\t\"firstname\": \"\",\n\t\t\"lastname\": \"\",\n\t\t\"fullname\": \"\",\n\t\t\"country\": \"USA\",\n\t\t\"country_id\": 9,\n\t\t\"city\": \"Berlin\",\n\t\t\"telegram\": \"seller\",\n\t\t\"whatsapp\": \"\",\n\t\t\"phone\": \"\",\n\t\t\"userpic\": \"\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Update profile settings",
					"request": {
						"method": "PATCH",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/settings",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"settings"
							]
						},
						"description": "Send only the fields you want to change: `phone`, `whatsapp`, `fullname`, `city`, `telegram` or `country_id`. An empty object returns `4012`.\n\nPhone fields accept 10 to 13 digits or an empty value. Names accept letters, spaces, apostrophes and hyphens, with a length of 2 to 128 characters. A leading `@` is removed from `telegram`; the remaining value must match `[a-zA-Z0-9_]{3,32}`. Use a `country_id` from `/catalog/country2data`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"city\": \"Berlin\",\n\t\"telegram\": \"@seller\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Update profile settings",
							"originalRequest": {
								"method": "PATCH",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/settings",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"settings"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"updated\": true,\n\t\t\"settings\": {\n\t\t\t\"id\": 8269,\n\t\t\t\"city\": \"Berlin\"\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Webhooks",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/webhooks",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"webhooks"
							]
						},
						"description": "Lists the delivery addresses of your account with the events they receive. The secret is never shown again; register the address again to get a new one.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Webhooks",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/webhooks",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"webhooks"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": 12,\n\t\t\t\t\"url\": \"https://partner.example.com/cytrongift/hook\",\n\t\t\t\t\"enabled\": true,\n\t\t\t\t\"events\": [\n\t\t\t\t\t\"order.completed\",\n\t\t\t\t\t\"order.rejected\",\n\t\t\t\t\t\"withdrawal.completed\",\n\t\t\t\t\t\"withdrawal.rejected\",\n\t\t\t\t\t\"application.approved\",\n\t\t\t\t\t\"application.rejected\",\n\t\t\t\t\t\"application.paused\"\n\t\t\t\t],\n\t\t\t\t\"created_at\": 1788605154\n\t\t\t}\n\t\t],\n\t\t\"limit\": 5\n\t}\n}"
						}
					]
				},
				{
					"name": "Add a webhook",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/webhooks",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"webhooks"
							]
						},
						"description": "Registers an https address for the events listed under Webhooks in the guide. The answer carries the `secret` once; registering an address you already hold issues a new secret for it. An address held by another account returns `4008`, an invalid one `4082`, the sixth address `4085`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"url\": \"https://partner.example.com/cytrongift/hook\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Add a webhook",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/webhooks",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"webhooks"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 12,\n\t\t\"url\": \"https://partner.example.com/cytrongift/hook\",\n\t\t\"enabled\": true,\n\t\t\"events\": [\n\t\t\t\"order.completed\",\n\t\t\t\"order.rejected\",\n\t\t\t\"withdrawal.completed\",\n\t\t\t\"withdrawal.rejected\",\n\t\t\t\"application.approved\",\n\t\t\t\"application.rejected\",\n\t\t\t\"application.paused\"\n\t\t],\n\t\t\"created_at\": 1788605154,\n\t\t\"secret\": \"7f3a...c9e1\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Delete a webhook",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/webhooks/delete",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"webhooks",
								"delete"
							]
						},
						"description": "Drops one address of your account; deliveries still waiting for it are cancelled. An unknown id, or one held by another account, returns `4007`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"id\": 12\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Delete a webhook",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/webhooks/delete",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"webhooks",
										"delete"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 12,\n\t\t\"deleted\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Profile",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/profile",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"profile"
							]
						},
						"description": "Returns who the acting user is, for an application's own screens. `display_name` is the full name, or the login when none is set; `username` is the Telegram handle; `avatar_url` is the uploaded picture, else the provider's photo, else `null`. `has_password` tells whether the account can sign in on the website with a password, `site_account` whether it has a mailbox or a password at all. `two_factor` tells whether two-factor authentication is on: sign-in by e-mail code and payouts made with a user token then ask for a code of the authenticator app. An account with `has_password` false gets its first website password through `POST /account/password/setup`. `email_verified` must be `true` before `POST /sell/cards`, `POST /sell/games` and `POST /withdrawal/create` accept the account; add an address with `POST /account/email`. `level` is the bonus level: `level`, `bonus` (percent), `unlock` (amount left to the next level) and `progress_to_next` (percent). `registered` is a unix time.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Profile",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/profile",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"profile"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 9001,\n\t\t\"login\": \"ada\",\n\t\t\"display_name\": \"Ada Lovelace\",\n\t\t\"username\": \"ada\",\n\t\t\"avatar_url\": \"https://cytrongift.com/uploads/userpic/9001.webp\",\n\t\t\"email\": \"ada@example.com\",\n\t\t\"email_verified\": true,\n\t\t\"has_password\": false,\n\t\t\"two_factor\": false,\n\t\t\"site_account\": true,\n\t\t\"ref_code\": \"ada7\",\n\t\t\"lang\": \"en\",\n\t\t\"level\": {\n\t\t\t\"level\": 2,\n\t\t\t\"bonus\": 1.5,\n\t\t\t\"unlock\": 120.5,\n\t\t\t\"progress_to_next\": 60\n\t\t},\n\t\t\"registered\": 1788600000\n\t}\n}"
						}
					]
				},
				{
					"name": "Add an e-mail address",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/email",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"email"
							]
						},
						"description": "Stores a mailbox for an account whose address is not yet confirmed and mails it the verification link at once; the link opens the website's verification page. A confirmed account answers `4082` with `already_verified`. An invalid address or a throwaway domain answers `4059`; an address another account holds answers `4087`. Verification mails are limited to one a minute and five an hour per account: a request too soon answers `4088` with `retry_after` in seconds. `retry_after` in the answer says when the next mail may be asked for.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"email\": \"ada@example.com\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Add an e-mail address",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/email",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"email"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"email\": \"ada@example.com\",\n\t\t\"email_verified\": false,\n\t\t\"sent\": true,\n\t\t\"retry_after\": 60\n\t}\n}"
						}
					]
				},
				{
					"name": "Resend the verification mail",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/email/resend",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"email",
								"resend"
							]
						},
						"description": "Mails the verification link to the stored address again. Each mail carries a new link; the link of an earlier mail stops working. An account without an address answers `4082` with `email_missing`, a confirmed one `4082` with `already_verified`. Verification mails are limited to one a minute and five an hour per account: a request too soon answers `4088` with `retry_after` in seconds.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Resend the verification mail",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/email/resend",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"email",
										"resend"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"email\": \"ada@example.com\",\n\t\t\"email_verified\": false,\n\t\t\"sent\": true,\n\t\t\"retry_after\": 60\n\t}\n}"
						}
					]
				},
				{
					"name": "Mail a one-time code",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/email/code",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"email",
								"code"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the proof belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nMails a fresh six-digit code to the confirmed address of the account, in the user's language, for an action your application guards on its own side. `purpose` is required and names that action; `pin_reset` (removing the app PIN of the Mini App) is the only one for now, anything else answers `400` with error `4082`. The code works for 15 minutes (`expires_in`, seconds) and a new mail voids the earlier code. The answer shows the address masked (`d***@mail.com`) and `retry_after`, the seconds before the next mail may be asked. One mail a minute and three an hour per account: a request too soon answers `429` with error `4158`, `retry_after` and a `Retry-After` header. An account without a confirmed address answers `403` with `4086`. Check the code with `POST /account/email/code/confirm`.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"purpose\": \"pin_reset\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Mail a one-time code",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/email/code",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"email",
										"code"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"sent\": true,\n\t\t\"email\": \"d***@mail.com\",\n\t\t\"expires_in\": 900,\n\t\t\"retry_after\": 60\n\t}\n}"
						}
					]
				},
				{
					"name": "Confirm a mailed code",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/email/code/confirm",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"email",
								"code",
								"confirm"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the proof belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nChecks the code of the latest `POST /account/email/code` mail for the same `purpose`. Send `code` as a string of six digits. A right code is spent at once and answers `verified: true`. A wrong one answers `400` with error `4159` and `attempts_left`; the fifth wrong try voids the code. No live code for the purpose (never sent, expired, used, replaced by a newer mail or out of tries) answers `409` with error `4160`: ask for a new mail. Never retry a wrong code automatically.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"purpose\": \"pin_reset\",\n\t\"code\": \"402518\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Confirm a mailed code",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/email/code/confirm",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"email",
										"code",
										"confirm"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"verified\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Two-factor state",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/2fa",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"2fa"
							]
						},
						"description": "Tells whether two-factor authentication is on for the acting account. It is the same switch as on the Security page of the website: enabling it in one place shows in the other, and one key serves both.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Two-factor state",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/2fa",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"2fa"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"enabled\": false\n\t}\n}"
						}
					]
				},
				{
					"name": "Start a two-factor setup",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/2fa/setup",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"2fa",
								"setup"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the second factor belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nReturns a new key for an authenticator app: `secret` (base32, for typing by hand), `uri` (the `otpauth://` address) and `qr`, the SVG markup of the QR code exactly as the website draws it (an empty string if it could not be drawn; the key still works). Nothing is switched on yet: the key waits with the account until `POST /account/2fa/enable` brings its first code, and asking again replaces it. An account with two-factor already on answers `409` with error `4152`; switch it off first.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Start a two-factor setup",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/2fa/setup",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"2fa",
										"setup"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"secret\": \"JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP\",\n\t\t\"uri\": \"otpauth://totp/Cytrongift:ada?secret=JBSWY3DPEHPK3PXPJBSWY3DPEHPK3PXP&issuer=Cytrongift&algorithm=SHA1&digits=6&period=30\",\n\t\t\"qr\": \"<svg xmlns=\\\"http://www.w3.org/2000/svg\\\" width=\\\"210\\\" height=\\\"210\\\" viewBox=\\\"0 0 53 53\\\">...</svg>\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Switch two-factor on",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/2fa/enable",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"2fa",
								"enable"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the second factor belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nSend `code`, the six digits the authenticator app shows for the key of `POST /account/2fa/setup`, as a string. A wrong code answers `400` with error `4151`; without a waiting setup the answer is `409` with `4153`, with two-factor already on `409` with `4152`. From this moment the website sign-in, the sign-in by e-mail code and payouts made with a user token ask for a code. The code that enabled it is used up: the next action needs the next code. Five wrong codes within 15 minutes lock the second factor of the account: `429` with error `4156` and `retry_after`.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"code\": \"918273\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Switch two-factor on",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/2fa/enable",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"2fa",
										"enable"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"enabled\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Switch two-factor off",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/2fa/disable",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"2fa",
								"disable"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the second factor belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nSend `code`, a live code of the authenticator app, as a string: a stolen session alone cannot remove the protection. A wrong or already used code answers `400` with error `4151`. The key is deleted; a later setup starts with a new one. Five wrong codes within 15 minutes lock the second factor of the account: `429` with error `4156` and `retry_after`.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"code\": \"918273\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Switch two-factor off",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/2fa/disable",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"2fa",
										"disable"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"enabled\": false\n\t}\n}"
						}
					]
				},
				{
					"name": "Check an authenticator code",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/2fa/verify",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"2fa",
								"verify"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the proof belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nChecks a live code of the authenticator app and changes nothing on the account, for an action your application guards on its own side (removing the app PIN of the Mini App, for example). Send `code` as a string of six digits. A right code is spent like anywhere else: it works once, so the next check needs the next code. A wrong or already used code answers `400` with error `4151` and counts against the account's lock: five wrong codes within 15 minutes, wherever they were sent, answer `429` with error `4156`, `retry_after` and a `Retry-After` header, even for a right code. An account with two-factor authentication off answers `409` with error `4157`; use `POST /account/email/code` instead.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"code\": \"918273\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Check an authenticator code",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/2fa/verify",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"2fa",
										"verify"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"verified\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Mail the first website password link",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/password/setup",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"password",
								"setup"
							]
						},
						"description": "Only for a user token (`Bearer ut_...`): the second factor belongs to the person, so a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nAn account created in an application has no password (`has_password` false in `GET /account/profile`). This mails the website's own password link to the confirmed address of the account, in the user's language; the link works once, for an hour, and a new mail voids the earlier link. An account that already has a password answers `409` with error `4154`: it changes the password through the recovery form of the website. An account without a confirmed address answers `403` with `4086`. One mail a minute and three an hour per account: a request too soon answers `429` with `4155` and `retry_after` in seconds. You may send `client_ip`, the visitor's address, which the site stores with the link.\n\nAuthentication: Bearer token.\nScope: `profile:write`.",
						"body": {
							"mode": "raw",
							"raw": "{}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Mail the first website password link",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/password/setup",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"password",
										"setup"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"sent\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "History",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/history?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"history"
							],
							"query": [
								{
									"key": "type",
									"value": "all",
									"description": "`all`, `cards`, `games` or `withdrawals` (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "The `next_cursor` of the previous page. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Your orders and payouts in one feed, newest first, 20 per page. `type` is `all` (default), `cards`, `games` or `withdrawals`. Pass the `next_cursor` of a page as `cursor` to read the next one; `null` means there is no more. A cursor of another `type` or a malformed one returns `4082`.\n\nAn order row has `kind` `cards` or `games`, the item and its brand or platform and region in both languages, `quantity`, `unit_price`, `amount` and `status` (`processing|complete|rejected|under_review`); a payout row has `kind: \"withdrawals\"`, `balance_source`, `amount` and `status`. Codes, comments and files come from `GET /account/history/item`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:read`."
					},
					"response": [
						{
							"name": "200 History",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/history?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"history"
									],
									"query": [
										{
											"key": "type",
											"value": "all",
											"description": "`all`, `cards`, `games` or `withdrawals` (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "The `next_cursor` of the previous page. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": \"82483\",\n\t\t\t\t\"kind\": \"cards\",\n\t\t\t\t\"item_id\": 2,\n\t\t\t\t\"name_en\": \"Apple iTunes 10 USD\",\n\t\t\t\t\"name_ru\": \"Apple iTunes 10 USD\",\n\t\t\t\t\"platform_en\": \"Apple\",\n\t\t\t\t\"platform_ru\": \"Apple\",\n\t\t\t\t\"country_en\": \"USA\",\n\t\t\t\t\"country_ru\": \"США\",\n\t\t\t\t\"quantity\": 1,\n\t\t\t\t\"unit_price\": 7.7,\n\t\t\t\t\"amount\": 7.7,\n\t\t\t\t\"status\": \"processing\",\n\t\t\t\t\"created_at\": \"2026-11-06T11:49:46Z\",\n\t\t\t\t\"currency\": \"USD\",\n\t\t\t\t\"symbol\": \"$\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"id\": \"18525\",\n\t\t\t\t\"kind\": \"withdrawals\",\n\t\t\t\t\"balance_source\": \"main\",\n\t\t\t\t\"amount\": 25,\n\t\t\t\t\"status\": \"processing\",\n\t\t\t\t\"created_at\": \"2026-11-06T11:50:09Z\",\n\t\t\t\t\"currency\": \"USD\",\n\t\t\t\t\"symbol\": \"$\"\n\t\t\t}\n\t\t],\n\t\t\"next_cursor\": \"v1.1793965746.0.82483\",\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\"\n\t}\n}"
						}
					]
				},
				{
					"name": "History item",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/history/item?kind=&id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"history",
								"item"
							],
							"query": [
								{
									"key": "kind",
									"value": "",
									"description": "`cards`, `games` or `withdrawals`",
									"disabled": false
								},
								{
									"key": "id",
									"value": "",
									"description": "The `id` of the history row.",
									"disabled": false
								},
								{
									"key": "balance_source",
									"value": "",
									"description": "`main` or `referral`, payouts only. (optional)",
									"disabled": true
								}
							]
						},
						"description": "One row of `GET /account/history` in full. For `kind` `cards` or `games` it adds the submitted `codes`, your `comment`, the operator's `admin_comment` (the reason of a rejection) and the `files` of the order, each with a `url` to `GET /account/order-image`. For `kind: \"withdrawals\"` it adds `amount_converted`, the `method`, `wallet`, `fio`, the `txid` of a completed payout and the `decline_reason` of a rejected one; `balance_source` (`main` or `referral`) narrows the lookup to payouts from that balance.\n\nA record that is not yours returns `4007`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:read`."
					},
					"response": [
						{
							"name": "200 History item",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/history/item?kind=&id=",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"history",
										"item"
									],
									"query": [
										{
											"key": "kind",
											"value": "",
											"description": "`cards`, `games` or `withdrawals`",
											"disabled": false
										},
										{
											"key": "id",
											"value": "",
											"description": "The `id` of the history row.",
											"disabled": false
										},
										{
											"key": "balance_source",
											"value": "",
											"description": "`main` or `referral`, payouts only. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": \"82483\",\n\t\t\"kind\": \"cards\",\n\t\t\"item_id\": 2,\n\t\t\"name_en\": \"Apple iTunes 10 USD\",\n\t\t\"name_ru\": \"Apple iTunes 10 USD\",\n\t\t\"platform_en\": \"Apple\",\n\t\t\"platform_ru\": \"Apple\",\n\t\t\"country_en\": \"USA\",\n\t\t\"country_ru\": \"США\",\n\t\t\"quantity\": 1,\n\t\t\"unit_price\": 7.7,\n\t\t\"amount\": 7.7,\n\t\t\"status\": \"processing\",\n\t\t\"created_at\": \"2026-11-06T11:49:46Z\",\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\",\n\t\t\"codes\": [],\n\t\t\"comment\": \"\",\n\t\t\"admin_comment\": \"\",\n\t\t\"files\": [\n\t\t\t{\n\t\t\t\t\"id\": \"54e18c2e55ce6227\",\n\t\t\t\t\"kind\": \"user\",\n\t\t\t\t\"name\": \"82483-user-0-7e182ff4.webp\",\n\t\t\t\t\"size\": 72,\n\t\t\t\t\"available\": true,\n\t\t\t\t\"url\": \"https://api.cytrongift.com/v1/account/order-image?token=54e18c2e55ce6227\"\n\t\t\t}\n\t\t]\n\t}\n}"
						}
					]
				},
				{
					"name": "Earnings summary",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/summary",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"summary"
							]
						},
						"description": "Lifetime earnings of your account in USD: `sales_earned` from completed orders, `referral_earned` from referral credits, and `cashflow`, their sum. Payouts do not reduce these figures.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Earnings summary",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/summary",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"summary"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"sales_earned\": 412.5,\n\t\t\"referral_earned\": 12.4,\n\t\t\"cashflow\": 424.9,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Referral programme",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/referrals",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"referrals"
							]
						},
						"description": "Your referral balance (`balance`, what you can withdraw with `balance_source: \"referral\"`), the members you invited (`invited`), the orders that paid you a credit (`orders`), the lifetime credits (`earned`) and your percent (`rate`).\n\n`code` is your invite code; `site_link` opens the site with it, and `telegram_link` opens the Mini App with it as the start parameter, or is `null` while the Mini App is not configured.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Referral programme",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/referrals",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"referrals"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"balance\": 1.5,\n\t\t\"invited\": 3,\n\t\t\"orders\": 5,\n\t\t\"earned\": 12.4,\n\t\t\"rate\": 5,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\",\n\t\t\"code\": \"cipartnerf20\",\n\t\t\"site_link\": \"https://cytrongift.com/?r=cipartnerf20\",\n\t\t\"telegram_link\": \"https://t.me/CytronGiftBot/app?startapp=cipartnerf20\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Referral history",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/referrals/history?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"referrals",
								"history"
							],
							"query": [
								{
									"key": "type",
									"value": "all",
									"description": "`all`, `referrals` or `withdrawals` (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "The `next_cursor` of the previous page. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Referral credits and the payouts from your referral balance in one feed, newest first, 20 per page. `type` is `all` (default), `referrals` or `withdrawals`; pass `next_cursor` as `cursor` for the next page. A credit row names the invited member (`user_login`) and the `amount`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `account:read`."
					},
					"response": [
						{
							"name": "200 Referral history",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/referrals/history?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"referrals",
										"history"
									],
									"query": [
										{
											"key": "type",
											"value": "all",
											"description": "`all`, `referrals` or `withdrawals` (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "The `next_cursor` of the previous page. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"id\": \"18526\",\n\t\t\t\t\"kind\": \"withdrawals\",\n\t\t\t\t\"balance_source\": \"referral\",\n\t\t\t\t\"amount\": 1.5,\n\t\t\t\t\"status\": \"processing\",\n\t\t\t\t\"created_at\": \"2026-11-06T11:50:20Z\",\n\t\t\t\t\"currency\": \"USD\",\n\t\t\t\t\"symbol\": \"$\"\n\t\t\t},\n\t\t\t{\n\t\t\t\t\"id\": \"311\",\n\t\t\t\t\"kind\": \"referrals\",\n\t\t\t\t\"user_login\": \"alex\",\n\t\t\t\t\"amount\": 0.38,\n\t\t\t\t\"status\": \"complete\",\n\t\t\t\t\"created_at\": \"2026-11-04T09:12:40Z\",\n\t\t\t\t\"currency\": \"USD\",\n\t\t\t\t\"symbol\": \"$\"\n\t\t\t}\n\t\t],\n\t\t\"next_cursor\": null,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\"\n\t}\n}"
						}
					]
				},
				{
					"name": "Telegram notification switch",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/account/notifications",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"notifications"
							]
						},
						"description": "For first-party applications: scope `notifications:manage`. Reads the Telegram notification switch of the acting user, keyed by the Telegram id of the user's identity. `enabled` is false until the user turns it on; `revision` counts the writes and is 0 for a switch that was never written.\n\nA user without a Telegram identity gets `4144`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `notifications:manage`."
					},
					"response": [
						{
							"name": "200 Telegram notification switch",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/notifications",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"notifications"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"enabled\": false,\n\t\t\"revision\": 0\n\t}\n}"
						}
					]
				},
				{
					"name": "Turn Telegram notifications on or off",
					"request": {
						"method": "PATCH",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/notifications",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"notifications"
							]
						},
						"description": "For first-party applications: scope `notifications:manage`. The body holds exactly two fields: `enabled` (boolean) and `revision` (integer), the revision you last read. Any other field, or a value of another type, returns `4082`.\n\nThe answer carries the new state with `revision` one higher. When the switch was written after you read it, the revision no longer matches and the call returns `4141`: read it again and repeat. Notifications go out in the language of the Telegram profile. A user without a Telegram identity gets `4144`; `4145` means another change of the same Telegram id is running, retry in a few seconds.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `notifications:manage`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"enabled\": true,\n\t\"revision\": 0\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Turn Telegram notifications on or off",
							"originalRequest": {
								"method": "PATCH",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/notifications",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"notifications"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"enabled\": true,\n\t\t\"revision\": 1\n\t}\n}"
						}
					]
				},
				{
					"name": "Report a security event",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/account/notifications/event",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"account",
								"notifications",
								"event"
							]
						},
						"description": "For first-party applications: scope `notifications:manage`, and only with a user token (`Bearer ut_...`); a request signed with an application key answers `403` `3014` with `reason: \"user_token_required\"`.\n\nTells the core that something happened to the member's security on your side, so the member hears it in Telegram from the bot. The body holds exactly one field, `event`; `pin_reset` (the app PIN of the Mini App was removed by a reset with a confirmation code) is the only one for now, anything else answers `400` with error `4082`. Never send the PIN or the code.\n\nThe answer says whether a message was queued: `false` when the member's Telegram notifications are off. The same event within an hour answers `429` with error `4161`, `retry_after` and a `Retry-After` header; treat it as done. Call it after the reset succeeded and do not let its failure undo the reset.\n\nAuthentication: Bearer token.\nScope: `notifications:manage`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"event\": \"pin_reset\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Report a security event",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/account/notifications/event",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"account",
										"notifications",
										"event"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"queued\": true\n\t}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Uploads",
			"description": "Upload card and receipt photos before attaching them to an order.",
			"item": [
				{
					"name": "Upload images",
					"request": {
						"method": "POST",
						"header": [],
						"url": {
							"raw": "{{base_url}}/uploads/images",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"uploads",
								"images"
							]
						},
						"description": "Upload card or receipt photos as `multipart/form-data`. For the HMAC signature, use an empty body.\n\nSend `type` as `card` or `receipt` (default: `card`), plus up to 10 images in `files[]`. For a single image, you can also use `file`. JPEG, PNG, GIF and WebP are accepted; the format is checked from the file contents. Each image must fit within the site's upload size limit.\n\nImages are converted to WebP, with the longest side limited to 2048 px. Originals are not kept. Attach the uploaded images to an order within 24 hours; unused uploads are deleted after that.\n\nTo make a retried upload safe, send one image with your own `upload_id` (32 lowercase hex characters). The same id with the same file returns the stored row again without storing a second copy; the same id with another file, another `type` or from another account returns `409` with error `4065`, and an id whose file is already attached to an order returns `4066`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`.",
						"body": {
							"mode": "formdata",
							"formdata": [
								{
									"key": "type",
									"value": "card",
									"type": "text",
									"description": "One of: card, receipt"
								},
								{
									"key": "files[]",
									"type": "file",
									"src": [],
									"description": "The image files."
								},
								{
									"key": "upload_id",
									"value": "",
									"type": "text",
									"description": ""
								}
							]
						}
					},
					"response": [
						{
							"name": "200 Upload images",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/uploads/images",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"uploads",
										"images"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [\n\t\t\t{\n\t\t\t\t\"upload_id\": \"941c...29f\",\n\t\t\t\t\"type\": \"card\",\n\t\t\t\t\"mime\": \"image/webp\",\n\t\t\t\t\"size\": 13352,\n\t\t\t\t\"w\": 2048,\n\t\t\t\t\"h\": 1365,\n\t\t\t\t\"created_at\": 1788605305,\n\t\t\t\t\"expires_at\": 1788691705\n\t\t\t}\n\t\t],\n\t\t\"total\": 1\n\t}\n}"
						}
					]
				},
				{
					"name": "Delete an unused upload",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/uploads/delete",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"uploads",
								"delete"
							]
						},
						"description": "Deletes an upload before it is attached to an order. An attached file returns `4066`, an upload owned by another account returns `4008`, and an unknown id returns `4007`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"upload_id\": \"941c...29f\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Delete an unused upload",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/uploads/delete",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"uploads",
										"delete"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"upload_id\": \"941c...29f\",\n\t\t\"deleted\": true\n\t}\n}"
						}
					]
				},
				{
					"name": "Upload limits and pending files",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/uploads/config",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"uploads",
								"config"
							]
						},
						"description": "Returns what `POST /uploads/images` accepts: the formats in `extensions`, the size limit of one image (`max_file_bytes`) and of one request (`max_batch_bytes`), the images per request (`max_files`) and how long an unused upload is kept (`expires_in`, seconds).\n\n`pending` lists your uploads that no order has claimed yet and that have not expired, newest first, at most 100, so a client can restore its queue after a restart.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`."
					},
					"response": [
						{
							"name": "200 Upload limits and pending files",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/uploads/config",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"uploads",
										"config"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"extensions\": [\n\t\t\t\"jpg\",\n\t\t\t\"png\",\n\t\t\t\"gif\",\n\t\t\t\"webp\",\n\t\t\t\"jpeg\"\n\t\t],\n\t\t\"max_file_bytes\": 52428800,\n\t\t\"max_batch_bytes\": 52428800,\n\t\t\"max_files\": 10,\n\t\t\"expires_in\": 86400,\n\t\t\"pending\": [\n\t\t\t{\n\t\t\t\t\"upload_id\": \"0123456789abcdef0123456789abcdef\",\n\t\t\t\t\"type\": \"card\",\n\t\t\t\t\"mime\": \"image/webp\",\n\t\t\t\t\"size\": 72,\n\t\t\t\t\"w\": 8,\n\t\t\t\t\"h\": 8,\n\t\t\t\t\"created_at\": 1793965776,\n\t\t\t\t\"expires_at\": 1794052176\n\t\t\t}\n\t\t]\n\t}\n}"
						}
					]
				},
				{
					"name": "Preview an upload",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/uploads/preview?upload_id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"uploads",
								"preview"
							],
							"query": [
								{
									"key": "upload_id",
									"value": "",
									"description": "The `upload_id` from `POST /uploads/images`.",
									"disabled": false
								}
							]
						},
						"description": "Returns the stored WebP of one of your pending uploads as `image/webp` with `Cache-Control: private, no-store`. An upload of another account returns `4008`; an unknown, expired or already attached one returns `4007` (attached files are read through `GET /account/order-image`).\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`."
					},
					"response": []
				}
			]
		},
		{
			"name": "Sell",
			"description": "Create orders to sell gift cards and game keys.",
			"item": [
				{
					"name": "Sell gift cards",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/sell/cards",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"sell",
								"cards"
							]
						},
						"description": "Creates a gift card order with status 0. Set `type` to 0 for any form, 1 for an e-code, or 2 for a physical card. The `gift_id` must be available for sale and match `brand_id` and `country_id`; a mismatch returns `4063`.\n\nSet `quantity` from 1 to 1000. You can add a `comment` of up to 1000 characters. In `cards`, send one code per line, up to 1000 codes with 4 to 92 characters each. Codes are required unless `type` is 2; physical cards require `card_upload_ids` instead. Missing card data returns `4064`. Uploads must belong to your account, match the required type and be unused by any other order.\n\nIn the response, `amount` is the payout per item, `total` includes the bonus for the whole order, and `net_total` is the total before the bonus.\n\nSend `request_id` (32 to 128 characters of `[A-Za-z0-9_-]`, or the `Idempotency-Key` header) to make retries safe. A repeat with the same id and the same body returns the stored answer with `duplicate: true` and creates nothing; the same id with a different body returns `409` with error `4065`. When you cannot tell whether a request arrived, ask `GET /sell/requests`: an id it has never seen is cancelled from then on, and a create with it returns `409` with error `4090`. Two requests of one account at the same moment wait for each other; after five seconds the second returns `4091`.\n\nAdd `expected_quote` with the `unit_price` and `total` from `POST /sell/quote` to sell only at that price: if the price moved, nothing is created and the answer is `200` with `status: \"price_changed\"` and the fresh `quote`. The acting account needs a confirmed e-mail address; otherwise the call answers `403` with error `4086`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"type\": 1,\n\t\"country_id\": 9,\n\t\"brand_id\": 1,\n\t\"gift_id\": 1,\n\t\"quantity\": 2,\n\t\"comment\": \"\",\n\t\"cards\": \"CODE-1\\\\nCODE-2\",\n\t\"card_upload_ids\": [],\n\t\"receipt_upload_ids\": [],\n\t\"request_id\": \"sell_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H\",\n\t\"expected_quote\": {\n\t\t\"unit_price\": 3.75,\n\t\t\"total\": 7.5\n\t}\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Sell gift cards",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/sell/cards",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"sell",
										"cards"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"order_id\": 75791,\n\t\t\"uuid\": \"455f...\",\n\t\t\"status\": 0,\n\t\t\"amount\": 3.75,\n\t\t\"total\": 7.5,\n\t\t\"net_total\": 0,\n\t\t\"quantity\": 2,\n\t\t\"files\": {\n\t\t\t\"cards\": [],\n\t\t\t\"receipts\": []\n\t\t},\n\t\t\"request_id\": \"sell_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H\",\n\t\t\"duplicate\": false\n\t}\n}"
						}
					]
				},
				{
					"name": "Sell game keys",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/sell/games",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"sell",
								"games"
							]
						},
						"description": "Works like `/sell/cards`, using `platform_id` instead of `brand_id`. If the platform has `receipt_required` enabled, include `receipt_upload_ids`; missing receipts return `4012`.\n\nSend `request_id` (32 to 128 characters of `[A-Za-z0-9_-]`, or the `Idempotency-Key` header) to make retries safe. A repeat with the same id and the same body returns the stored answer with `duplicate: true` and creates nothing; the same id with a different body returns `409` with error `4065`. When you cannot tell whether a request arrived, ask `GET /sell/requests`: an id it has never seen is cancelled from then on, and a create with it returns `409` with error `4090`. Two requests of one account at the same moment wait for each other; after five seconds the second returns `4091`.\n\nAdd `expected_quote` with the `unit_price` and `total` from `POST /sell/quote` to sell only at that price: if the price moved, nothing is created and the answer is `200` with `status: \"price_changed\"` and the fresh `quote`. The acting account needs a confirmed e-mail address; otherwise the call answers `403` with error `4086`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"type\": 1,\n\t\"country_id\": 9,\n\t\"platform_id\": 1,\n\t\"gift_id\": 1,\n\t\"quantity\": 1,\n\t\"cards\": \"KEY-1\",\n\t\"receipt_upload_ids\": [],\n\t\"request_id\": \"sell_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H\",\n\t\"expected_quote\": {\n\t\t\"unit_price\": 3.75,\n\t\t\"total\": 7.5\n\t}\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Sell game keys",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/sell/games",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"sell",
										"games"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"order_id\": 75792,\n\t\t\"uuid\": \"9a1c...\",\n\t\t\"status\": 0,\n\t\t\"amount\": 12,\n\t\t\"total\": 12,\n\t\t\"net_total\": 0,\n\t\t\"quantity\": 1,\n\t\t\"files\": {\n\t\t\t\"cards\": [],\n\t\t\t\"receipts\": []\n\t\t},\n\t\t\"request_id\": \"sell_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H\",\n\t\t\"duplicate\": false\n\t}\n}"
						}
					]
				},
				{
					"name": "Quote a sale",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/sell/quote",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"sell",
								"quote"
							]
						},
						"description": "Prices one selection for your account without opening an order: the payout per item (`unit_price`), the order before the bonus (`subtotal`) and with your bonus level applied (`total`, `bonus_percent`, `bonus_amount`), in USD.\n\nSet `kind` to `cards` or `games`. `item_id` is the card or game, `category_id` its brand or platform and `country_id` its region, as `/catalog/cards` and `/catalog/games` list them; `quantity` is 1 to 1000. An item that is no longer on sale returns `4062`; ids that do not belong together return `4063` with the expected ids in `extra`.\n\nPass `unit_price` and `total` back as `expected_quote` when you create the order, so a price that moved in between is reported instead of accepted. The acting account needs a confirmed e-mail address; otherwise the call answers `403` with error `4086`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"kind\": \"cards\",\n\t\"item_id\": 1,\n\t\"category_id\": 1,\n\t\"country_id\": 9,\n\t\"quantity\": 2\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Quote a sale",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/sell/quote",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"sell",
										"quote"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"kind\": \"cards\",\n\t\t\"item_id\": 1,\n\t\t\"category_id\": 1,\n\t\t\"country_id\": 9,\n\t\t\"quantity\": 2,\n\t\t\"unit_price\": 3.75,\n\t\t\"subtotal\": 7.5,\n\t\t\"total\": 7.5,\n\t\t\"bonus_percent\": 0,\n\t\t\"bonus_amount\": 0,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\",\n\t\t\"quoted_at\": 1793965740\n\t}\n}"
						}
					]
				},
				{
					"name": "Outcome of a sale request",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/sell/requests?request_id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"sell",
								"requests"
							],
							"query": [
								{
									"key": "request_id",
									"value": "",
									"description": "The id you sent with the create.",
									"disabled": false
								}
							]
						},
						"description": "Returns what happened to a `request_id` you sent to `POST /sell/cards` or `POST /sell/games`. A known id returns the stored answer of that create with `state: \"done\"`.\n\nAn id the server has never seen returns `status: \"cancelled\"` and `state: \"cancelled\"`, and from that moment a create with it is refused with `4090`. So after a timeout, ask here first: either the order exists, or you know for sure it never will and can send the sale again with a new id. A request id has 32 to 128 characters of `[A-Za-z0-9_-]`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:write`."
					},
					"response": [
						{
							"name": "200 Outcome of a sale request",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/sell/requests?request_id=",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"sell",
										"requests"
									],
									"query": [
										{
											"key": "request_id",
											"value": "",
											"description": "The id you sent with the create.",
											"disabled": false
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"order_id\": 82482,\n\t\t\"uuid\": \"ade8...\",\n\t\t\"status\": 0,\n\t\t\"amount\": 3.75,\n\t\t\"total\": 3.75,\n\t\t\"net_total\": 0,\n\t\t\"quantity\": 1,\n\t\t\"files\": {\n\t\t\t\"cards\": [],\n\t\t\t\"receipts\": []\n\t\t},\n\t\t\"request_id\": \"sell_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H\",\n\t\t\"state\": \"done\"\n\t}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Withdrawals",
			"description": "Request payouts and check their status and history.",
			"item": [
				{
					"name": "Request a payout",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/withdrawal/create",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"withdrawal",
								"create"
							]
						},
						"description": "Set `amount` to a positive number with up to 2 decimal places. It is deducted from your balance as soon as the request is created. Use `amount_type` 0 for your main balance or 1 for your referral balance.\n\nChoose a `method_id` from `/catalog/payments` with a current rate. The `wallet` must match the method's format, or you get `4053`. Include `fio` if the method has `needs_fio` enabled.\n\nUse `request_id` to make retries safe. It must match `[a-zA-Z0-9_-]{16,128}`. Repeating the same request with the same id returns the original record with `duplicate: true`. Reusing that id with different content returns HTTP `409` with error `4065`. If you omit the field, you can pass the value in the `Idempotency-Key` header instead.\n\nIf your balance is too low, you get `4054`, with `available` and `requested` amounts in `extra`.\n\nInstead of `amount` and `amount_type` you may send `balance_source` (`main` or `referral`): the payout is then the whole balance of that source at the moment of the request, as `POST /withdrawal/quote` shows it; an empty balance returns `4054`. The two forms cannot be mixed.\n\nAdd `expected_quote` with `amount`, `amount_converted`, `currency`, `method_currency` and `method_network` to pay out only that: if anything moved, nothing is debited and the answer is `200` with `status: \"price_changed\"` and the fresh `quote`.\n\nA `request_id` of 32 characters or more also gets a receipt: a retry returns the stored answer with `duplicate: true`, `GET /withdrawal/requests` reports its outcome, and an id that lookup cancelled is refused with `4090`. Two requests of one account at the same moment wait for each other; after five seconds the second returns `4091`. The acting account needs a confirmed e-mail address; otherwise the call answers `403` with error `4086`.\n\nThe whole-balance form looks like this: `{\"request_id\": \"wd_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H4J\", \"balance_source\": \"main\", \"method_id\": 2, \"wallet\": \"bc1q...\", \"expected_quote\": {\"amount\": 25, \"amount_converted\": 0.00030464, \"currency\": \"USD\", \"method_currency\": \"BTC\", \"method_network\": \"BTC\"}}`.\n\n**Two-factor authentication.** A request made with a user token (`Bearer ut_...`, a person signed in through `POST /auth/identity`) for an account with two-factor authentication on must carry `totp`, the six digits of the authenticator app as a string. Without it the answer is `403` with error `4150` (`totp_required`), with a wrong or already used code `400` with `4151` (`totp_invalid`); nothing is debited either way, and the same `request_id` may be sent again with the code. A code works once: two payouts in a row need two different codes, about 30 seconds apart. The code is asked after every other check, so a refused payout or a `price_changed` answer does not use it up, and a retry answered from the receipt needs none. Requests signed with an application key, and JWTs of `POST /auth`, are never asked. `GET /account/profile` tells in `two_factor` whether the account has it on. **Lock.** Five wrong codes of one account within 15 minutes, counted together across the website and every endpoint that asks for a code, lock its second factor until that window ends: the answer is then `429` with error `4156` (`totp_locked`), `retry_after` in seconds and a `Retry-After` header, even for a right code. Show the wait and do not retry before it.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `withdrawals:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"amount\": 10.5,\n\t\"method_id\": 2,\n\t\"wallet\": \"1A1zP1...\",\n\t\"fio\": \"John Doe\",\n\t\"amount_type\": 0,\n\t\"request_id\": \"wd_01K1A8T4S7Q2M5N9P3R6\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Request a payout",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/withdrawal/create",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"withdrawal",
										"create"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 15870,\n\t\t\"uuid\": \"f28f...\",\n\t\t\"status\": 0,\n\t\t\"amount\": 10.5,\n\t\t\"amount_converted\": 0.00013169,\n\t\t\"amount_type\": 0,\n\t\t\"balance_source\": \"main\",\n\t\t\"method_id\": 2,\n\t\t\"wallet\": \"1A1zP1...\",\n\t\t\"date_create\": 1788605258,\n\t\t\"request_id\": \"wd_01K1A8T4S7Q2M5N9P3R6\",\n\t\t\"duplicate\": false\n\t}\n}"
						}
					]
				},
				{
					"name": "Payout history",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/withdrawal/transactions?",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"withdrawal",
								"transactions"
							],
							"query": [
								{
									"key": "id",
									"value": "",
									"description": "Return one payout directly in `data`, without the list wrapper. (optional)",
									"disabled": true
								},
								{
									"key": "type",
									"value": "",
									"description": "`main` or `referral` (optional)",
									"disabled": true
								},
								{
									"key": "cursor",
									"value": "",
									"description": "Return items with ids less than this cursor. (optional)",
									"disabled": true
								},
								{
									"key": "limit",
									"value": "20",
									"description": "Items per page: 1 to 200. (optional)",
									"disabled": true
								}
							]
						},
						"description": "Returns your payouts, newest first. Each item includes `id`, `uuid`, `type`, `status` (`processing|complete|rejected`), `status_id`, `amount`, `amount_converted`, `amount_type`, `wallet`, `fio`, `tx_out`, `date_create`, `date_result` and `method`.\n\nThe `method` object contains `id`, `currency`, `name_ru` and `name_en` as they were when the payout was created.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `orders:read`."
					},
					"response": [
						{
							"name": "200 Payout history",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/withdrawal/transactions?",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"withdrawal",
										"transactions"
									],
									"query": [
										{
											"key": "id",
											"value": "",
											"description": "Return one payout directly in `data`, without the list wrapper. (optional)",
											"disabled": true
										},
										{
											"key": "type",
											"value": "",
											"description": "`main` or `referral` (optional)",
											"disabled": true
										},
										{
											"key": "cursor",
											"value": "",
											"description": "Return items with ids less than this cursor. (optional)",
											"disabled": true
										},
										{
											"key": "limit",
											"value": "20",
											"description": "Items per page: 1 to 200. (optional)",
											"disabled": true
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"items\": [],\n\t\t\"limit\": 20,\n\t\t\"cursor\": 0,\n\t\t\"next_cursor\": null,\n\t\t\"filters\": {\n\t\t\t\"type\": null\n\t\t}\n\t}\n}"
						}
					]
				},
				{
					"name": "Quote a payout",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/withdrawal/quote",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"withdrawal",
								"quote"
							]
						},
						"description": "Calculates the payout of the whole balance of one source: `balance_source` is `main` or `referral`, `method_id` a method from `/catalog/payments` with a current rate (else `4052`). Nothing is reserved.\n\nThe answer carries both fresh `balances`, the method, the `amount` in USD, the `amount_converted` in the method currency (8 decimals) and `eligible`, false when that balance is empty. Pass `amount`, `amount_converted`, `currency`, `method.currency` and `method.network` back as `expected_quote` of `POST /withdrawal/create`. The acting account needs a confirmed e-mail address; otherwise the call answers `403` with error `4086`.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `withdrawals:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"balance_source\": \"main\",\n\t\"method_id\": 2\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Quote a payout",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/withdrawal/quote",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"withdrawal",
										"quote"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"balance_source\": \"main\",\n\t\t\"method_id\": 2,\n\t\t\"currency\": \"USD\",\n\t\t\"symbol\": \"$\",\n\t\t\"balances\": {\n\t\t\t\"main\": 25,\n\t\t\t\"referral\": 3\n\t\t},\n\t\t\"method\": {\n\t\t\t\"id\": 2,\n\t\t\t\"code\": \"BTC\",\n\t\t\t\"currency\": \"BTC\",\n\t\t\t\"network\": \"BTC\",\n\t\t\t\"name_ru\": \"Bitcoin\",\n\t\t\t\"name_en\": \"Bitcoin\",\n\t\t\t\"example\": \"bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4\",\n\t\t\t\"rate_date\": 1791997622,\n\t\t\t\"needs_fio\": false,\n\t\t\t\"has_image\": true\n\t\t},\n\t\t\"amount\": 25,\n\t\t\"amount_converted\": 0.00030464,\n\t\t\"eligible\": true,\n\t\t\"quoted_at\": 1793965801\n\t}\n}"
						}
					]
				},
				{
					"name": "Outcome of a payout request",
					"request": {
						"method": "GET",
						"header": [],
						"url": {
							"raw": "{{base_url}}/withdrawal/requests?request_id=",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"withdrawal",
								"requests"
							],
							"query": [
								{
									"key": "request_id",
									"value": "",
									"description": "The id you sent with the create.",
									"disabled": false
								}
							]
						},
						"description": "Returns what happened to a `request_id` of 32 to 128 characters you sent to `POST /withdrawal/create`, with your fresh `balances`. A known id returns the payout answer with `state: \"done\"`, also for a payout made before receipts existed.\n\nAn id the server has never seen returns `status: \"cancelled\"`, and from then on a create with it is refused with `4090`, so after a timeout you know for sure whether money left the balance.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `withdrawals:write`."
					},
					"response": [
						{
							"name": "200 Outcome of a payout request",
							"originalRequest": {
								"method": "GET",
								"header": [],
								"url": {
									"raw": "{{base_url}}/withdrawal/requests?request_id=",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"withdrawal",
										"requests"
									],
									"query": [
										{
											"key": "request_id",
											"value": "",
											"description": "The id you sent with the create.",
											"disabled": false
										}
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"id\": 18525,\n\t\t\"uuid\": \"9d71...\",\n\t\t\"status\": 0,\n\t\t\"amount\": 25,\n\t\t\"amount_converted\": 0.00030464,\n\t\t\"amount_type\": 0,\n\t\t\"balance_source\": \"main\",\n\t\t\"method_id\": 2,\n\t\t\"wallet\": \"bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4\",\n\t\t\"date_create\": 1793965809,\n\t\t\"request_id\": \"wd_01K9ZP4M3R7T2W6Y8B5C1D9F0G3H4J\",\n\t\t\"state\": \"done\",\n\t\t\"balances\": {\n\t\t\t\"main\": 0,\n\t\t\t\"referral\": 3\n\t\t}\n\t}\n}"
						}
					]
				}
			]
		},
		{
			"name": "Support",
			"description": "Create support tickets you can also follow in your account.",
			"item": [
				{
					"name": "Create a support ticket",
					"request": {
						"method": "POST",
						"header": [
							{
								"key": "Content-Type",
								"value": "application/json"
							}
						],
						"url": {
							"raw": "{{base_url}}/support/create",
							"host": [
								"{{base_url}}"
							],
							"path": [
								"support",
								"create"
							]
						},
						"description": "Creates a ticket you can also follow in your account on the website. If you omit `name` or `email`, the values from your profile are used.\n\nThe `subject` must be 3 to 64 characters; the `message`, 20 to 8192. The same flood protection as on the website applies (`3011`). The response includes `code` for guest access to the conversation.\n\nAuthentication: HMAC signature (X-Api-Key, X-Timestamp, X-Signature) or Bearer token.\nScope: `support:write`.",
						"body": {
							"mode": "raw",
							"raw": "{\n\t\"subject\": \"Question\",\n\t\"message\": \"At least twenty characters of text.\",\n\t\"name\": \"John Doe\",\n\t\"email\": \"john@example.com\",\n\t\"lang\": \"en\"\n}",
							"options": {
								"raw": {
									"language": "json"
								}
							}
						}
					},
					"response": [
						{
							"name": "200 Create a support ticket",
							"originalRequest": {
								"method": "POST",
								"header": [],
								"url": {
									"raw": "{{base_url}}/support/create",
									"host": [
										"{{base_url}}"
									],
									"path": [
										"support",
										"create"
									]
								}
							},
							"status": "OK",
							"code": 200,
							"_postman_previewlanguage": "json",
							"header": [
								{
									"key": "Content-Type",
									"value": "application/json; charset=utf-8"
								}
							],
							"body": "{\n\t\"ok\": 1,\n\t\"data\": {\n\t\t\"ticket_id\": 1888,\n\t\t\"code\": \"b296...\",\n\t\t\"status\": 0,\n\t\t\"name\": \"John Doe\",\n\t\t\"email\": \"john@example.com\",\n\t\t\"subject\": \"Question\",\n\t\t\"date\": 1788605297\n\t}\n}"
						}
					]
				}
			]
		}
	],
	"event": [
		{
			"listen": "prerequest",
			"script": {
				"type": "text/javascript",
				"exec": [
					"// Signs the request the way the guide describes: METHOD \\n PATH \\n TIMESTAMP \\n RAW_BODY with the secret.",
					"// Skipped when the request already carries an Authorization header (bearer token) or no key is set.",
					"if (pm.request.headers.has('Authorization')) { return; }",
					"var key = pm.variables.get('api_key'), secret = pm.variables.get('api_secret');",
					"if (!key || !secret) { return; }",
					"var url \t= pm.request.url.toString().replace(/\\{\\{base_url\\}\\}/, pm.variables.get('base_url'));",
					"var path \t= url.replace(/\\?.*$/, '').replace(/^.*?\\/v1(?=\\/|$)/, '');",
					"var ts \t\t= Math.floor(Date.now() / 1000).toString();",
					"var body \t= '';",
					"if (pm.request.body && pm.request.body.mode === 'raw' && pm.request.body.raw) {",
					"\tbody = pm.request.body.raw;",
					"}",
					"var sig = CryptoJS.HmacSHA256(pm.request.method + \"\\n\" + path + \"\\n\" + ts + \"\\n\" + body, secret).toString();",
					"pm.request.headers.upsert({ key: 'X-Api-Key', value: key });",
					"pm.request.headers.upsert({ key: 'X-Timestamp', value: ts });",
					"pm.request.headers.upsert({ key: 'X-Signature', value: sig });"
				]
			}
		}
	],
	"variable": [
		{
			"key": "base_url",
			"value": "https://api.cytrongift.com/v1",
			"description": "Live or sandbox base URL; the environments set it."
		},
		{
			"key": "api_key",
			"value": "",
			"description": "Key ID (ck_... live, cks_... sandbox)."
		},
		{
			"key": "api_secret",
			"value": "",
			"description": "Secret (cs_...), shown once in Apps & API."
		},
		{
			"key": "bearer_token",
			"value": "",
			"description": "Filled by \"Get a bearer token\"."
		}
	]
}