Для AI-агентов: markdown этой страницы — /docs/api-orders.mdиндекс документации — /llms.txt
REST: orders
Обновлено
REST: orders
Операции этой группы относятся к текущему Hub REST-контракту. В каждой записи приведены полные request/response, ошибки, auth, scopes, headers, pagination и idempotency из принятого producer. Для requiredScopes действует ALL; между auth alternatives действует OR, внутри одной альтернативы — ALL. Пустой список scopes не отменяет указанную аутентификацию. HTTP 304 остаётся отдельным ответом без тела. Не переносите чужие лимиты или заголовки: ниже перечислены только объявленные значения данной операции. Адреса объектов и курсоры описаны в идентификаторах, авторизация — в руководстве, диагностика — в ошибках.
listOrders
GET /api/v1/orders — listOrders
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "INVALID_FILTER rejects unknown/legacy fields or invalid sequence bounds; INVALID_CURSOR rejects format, expiry, filter or tenant mismatch"
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing, invalid, expired or revoked authentication"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Required scope, plan or resource policy refused the caller"
}
},
"headers": {
"request": [],
"response": {
"200": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "listOrders",
"pagination": {
"contract": null,
"parameters": [
{
"in": "query",
"name": "cursor",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"maximum": 200,
"minimum": 1,
"type": "integer"
}
}
]
},
"request": {
"body": null,
"parameters": [
{
"description": "Scalar or comma-separated IN list of at most 100 positive int4 User sequences. Each value is checked against 1..2147483647 and resolved through the authenticated tenant User relation. Legacy user_id is rejected.",
"in": "query",
"name": "user_seq_num",
"required": false,
"schema": {
"oneOf": [
{
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
{
"pattern": "^[1-9][0-9]*(,[1-9][0-9]*)*$",
"type": "string"
}
]
}
},
{
"in": "query",
"name": "cursor",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"maximum": 200,
"minimum": 1,
"type": "integer"
}
},
{
"in": "query",
"name": "sort",
"required": false,
"schema": {
"type": "string"
}
},
{
"in": "query",
"name": "include",
"required": false,
"schema": {
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"data": {
"items": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"created_at": {
"format": "date-time",
"type": "string"
},
"currency": {
"type": "string"
},
"external_order_ref": {
"type": [
"string",
"null"
]
},
"seq_num": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"status": {
"enum": [
"pending",
"paid",
"canceled",
"expired",
"linked"
],
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"seq_num",
"status",
"amount",
"currency",
"external_order_ref",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
},
"meta": {
"properties": {
"estimated_total": {
"minimum": 0,
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"limit": {
"exclusiveMinimum": 0,
"type": "integer"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"required": [
"has_more",
"next_cursor",
"limit"
],
"type": "object"
},
"success": {
"enum": [
true
],
"type": "boolean"
}
},
"required": [
"success",
"data",
"meta"
],
"type": "object"
}
}
},
"description": "List external orders"
}
},
"scopes": [
"pull:orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=listOrders]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "listOrders",
"path": "/api/v1/orders",
"requestSchemaRef": null,
"requiredScopes": [
"pull:orders"
],
"responseSchemaRefs": {
"200": "#/components/schemas/OrderPullList",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "listOrders"
}
}getOrder
GET /api/v1/orders/{id} — getOrder
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing, invalid, expired or revoked authentication"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Required scope, plan or resource policy refused the caller"
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The tenant Order sequence is invalid or no Order exists for this authenticated tenant"
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {},
"404": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "getOrder",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"description": "Tenant Order sequence serialized as canonical decimal digits; no leading zero, sign, exponent or fractional form.",
"in": "path",
"name": "id",
"required": true,
"schema": {
"description": "Tenant Order sequence serialized as canonical decimal digits; no leading zero, sign, exponent or fractional form.",
"maximum": 2147483647,
"minimum": 1,
"pattern": "^[1-9]\\d*$",
"type": "integer"
}
},
{
"in": "query",
"name": "include",
"required": false,
"schema": {
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"created_at": {
"format": "date-time",
"type": "string"
},
"currency": {
"type": "string"
},
"external_order_ref": {
"type": [
"string",
"null"
]
},
"seq_num": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"status": {
"enum": [
"pending",
"paid",
"canceled",
"expired",
"linked"
],
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"seq_num",
"status",
"amount",
"currency",
"external_order_ref",
"created_at",
"updated_at"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"items": {
"items": {
"additionalProperties": false,
"properties": {
"catalog_seq_num": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"line_no": {
"exclusiveMinimum": 0,
"type": "integer"
},
"line_total": {
"type": "string"
},
"measurement_unit": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"quantity": {
"exclusiveMinimum": 0,
"type": "integer"
},
"sku_code": {
"type": [
"string",
"null"
]
},
"title_snapshot": {
"type": "string"
},
"unit_amount": {
"type": "string"
},
"variant_snapshot": {
"additionalProperties": {},
"type": [
"object",
"null"
]
}
},
"required": [
"line_no",
"catalog_seq_num",
"title_snapshot",
"variant_snapshot",
"sku_code",
"measurement_unit",
"quantity",
"unit_amount",
"line_total",
"note"
],
"type": "object"
},
"type": "array"
},
"payments": {
"items": {
"additionalProperties": false,
"properties": {
"amount": {
"type": "string"
},
"created_at": {
"format": "date-time",
"type": "string"
},
"currency": {
"type": "string"
},
"provider": {
"type": "string"
},
"provider_payment_id": {
"type": "string"
},
"status": {
"type": "string"
},
"updated_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"currency",
"provider",
"status",
"created_at",
"updated_at"
],
"type": "object"
},
"type": "array"
},
"user": {
"additionalProperties": false,
"properties": {
"seq_num": {
"exclusiveMinimum": 0,
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"seq_num"
],
"type": "object"
}
},
"type": "object"
}
]
}
}
},
"description": "Get external order"
}
},
"scopes": [
"pull:orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=getOrder]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getOrder",
"path": "/api/v1/orders/{id}",
"requestSchemaRef": null,
"requiredScopes": [
"pull:orders"
],
"responseSchemaRefs": {
"200": "#/components/schemas/OrderPullDetail",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "getOrder"
}
}createOrder
POST /api/v1/orders — createOrder
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The accepted pricing quote is malformed, forged, or bound to a different tenant, subject, surface, zone, or basket"
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing or invalid authentication"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The caller lacks the orders scope or tenant access"
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "A product or requested user was not found for this tenant"
},
"409": {
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
},
{
"properties": {
"code": {
"enum": [
"PRICE_CHANGED"
],
"type": "string"
},
"details": {
"additionalProperties": false,
"properties": {
"freshQuote": {
"additionalProperties": false,
"properties": {
"amount": {
"minLength": 1,
"type": "string"
},
"cart_version": {
"exclusiveMinimum": 0,
"type": [
"integer",
"null"
]
},
"currency": {
"enum": [
"RUB",
"USD",
"EUR",
"XTR",
"USDT",
"TON",
"BTC",
"ETH",
"LTC",
"BNB",
"TRX",
"USDC"
],
"type": "string"
},
"expires_at": {
"format": "date-time",
"type": "string"
},
"pricing_revision": {
"minLength": 1,
"type": "string"
},
"signature": {
"minLength": 1,
"type": "string"
}
},
"required": [
"cart_version",
"pricing_revision",
"amount",
"currency",
"expires_at",
"signature"
],
"type": "object"
}
},
"required": [
"freshQuote"
],
"type": "object"
}
},
"required": [
"details"
],
"type": "object"
}
]
}
}
},
"description": "The accepted quote is stale. `details.freshQuote` contains the sole new six-field signed quote; retry with a new Idempotency-Key."
},
"422": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The basket is invalid or a RU fiscal route requires a valid buyer email or phone (YooKassa requires email)"
},
"428": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "An accepted six-field pricing quote is required"
}
},
"headers": {
"request": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {},
"404": {},
"409": {},
"422": {},
"428": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "createOrder",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"additionalProperties": false,
"properties": {
"buyer_email": {
"format": "email",
"maxLength": 254,
"type": "string"
},
"buyer_inn": {
"pattern": "^\\d{10}(?:\\d{2})?$",
"type": "string"
},
"buyer_phone": {
"maxLength": 32,
"minLength": 10,
"type": "string"
},
"checkout_notes": {
"maxLength": 2000,
"type": "string"
},
"delivery_address": {
"properties": {
"apartment": {
"maxLength": 20,
"type": "string"
},
"building": {
"maxLength": 20,
"type": "string"
},
"city": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"comment": {
"maxLength": 300,
"type": "string"
},
"entrance": {
"maxLength": 10,
"type": "string"
},
"floor": {
"maxLength": 10,
"type": "string"
},
"house": {
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"intercom": {
"maxLength": 20,
"type": "string"
},
"postal_code": {
"maxLength": 20,
"type": "string"
},
"street": {
"maxLength": 150,
"minLength": 1,
"type": "string"
}
},
"required": [
"city",
"street",
"house"
],
"type": "object"
},
"external_order_ref": {
"maxLength": 255,
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"note": {
"maxLength": 500,
"type": "string"
},
"product_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"quantity": {
"exclusiveMinimum": 0,
"type": "integer"
},
"selected_options": {
"additionalProperties": {
"items": {
"pattern": "^[a-z0-9_]{1,16}$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"type": "object"
}
},
"required": [
"product_seq_id",
"quantity"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"metadata": {
"additionalProperties": {},
"type": "object"
},
"redirect_url": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"user_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"items",
"zone"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"accepted_pricing_quote": {
"additionalProperties": false,
"properties": {
"amount": {
"minLength": 1,
"type": "string"
},
"cart_version": {
"exclusiveMinimum": 0,
"type": [
"integer",
"null"
]
},
"currency": {
"enum": [
"RUB",
"USD",
"EUR",
"XTR",
"USDT",
"TON",
"BTC",
"ETH",
"LTC",
"BNB",
"TRX",
"USDC"
],
"type": "string"
},
"expires_at": {
"format": "date-time",
"type": "string"
},
"pricing_revision": {
"minLength": 1,
"type": "string"
},
"signature": {
"minLength": 1,
"type": "string"
}
},
"required": [
"cart_version",
"pricing_revision",
"amount",
"currency",
"expires_at",
"signature"
],
"type": "object"
}
},
"required": [
"accepted_pricing_quote"
],
"type": "object"
}
]
}
}
},
"required": true
},
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"example": {
"display_number": "#1042",
"items": [
{
"catalog_seq_num": 42,
"currency": "RUB",
"line_no": 1,
"quantity": 1,
"title": "Consultation",
"unit_amount": "1500.00"
}
],
"order_number": "1042",
"payment_urls": {
"yookassa": "https://pay.example.test/order/1042"
},
"seq_num": 1042,
"status": "pending",
"zone": "ru"
},
"properties": {
"display_number": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"example": {
"catalog_seq_num": 42,
"currency": "RUB",
"line_no": 1,
"quantity": 1,
"title": "Consultation",
"unit_amount": "1500.00"
},
"properties": {
"catalog_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"description": {
"type": "string"
},
"line_no": {
"exclusiveMinimum": 0,
"type": "integer"
},
"quantity": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"unit_amount": {
"type": "string"
}
},
"required": [
"line_no",
"catalog_seq_num",
"title",
"quantity",
"unit_amount",
"currency"
],
"type": "object"
},
"type": "array"
},
"order_number": {
"type": "string"
},
"payment_urls": {
"additionalProperties": {
"format": "uri",
"type": "string"
},
"type": "object"
},
"seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"status": {
"enum": [
"pending",
"paid",
"canceled",
"expired",
"linked"
],
"type": "string"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"seq_num",
"order_number",
"display_number",
"status",
"items",
"payment_urls",
"zone"
],
"type": "object"
}
}
},
"description": "Create external order"
}
},
"scopes": [
"orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=createOrder]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "createOrder",
"path": "/api/v1/orders",
"requestSchemaRef": "#/components/schemas/CreateOrderRequest",
"requiredScopes": [
"orders"
],
"responseSchemaRefs": {
"201": "#/components/schemas/CreateOrderResponse",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails",
"409": null,
"422": "#/components/schemas/ProblemDetails",
"428": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "createOrder"
}
}quoteOrder
POST /api/v1/orders/quote — quoteOrder
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Malformed request or a missing Idempotency-Key header"
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing or invalid authentication"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The caller lacks the orders scope or tenant access"
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "A product or requested user was not found for this tenant"
},
"409": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "A request with this Idempotency-Key is already in progress"
},
"422": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The basket, product selection, currency, provider intersection, or receipt-contact policy is invalid"
},
"503": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Pricing is temporarily unavailable"
}
},
"headers": {
"request": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {},
"404": {},
"409": {},
"422": {},
"503": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "quoteOrder",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"buyer_email": {
"format": "email",
"maxLength": 254,
"type": "string"
},
"buyer_inn": {
"pattern": "^\\d{10}(?:\\d{2})?$",
"type": "string"
},
"buyer_phone": {
"maxLength": 32,
"minLength": 10,
"type": "string"
},
"checkout_notes": {
"maxLength": 2000,
"type": "string"
},
"delivery_address": {
"properties": {
"apartment": {
"maxLength": 20,
"type": "string"
},
"building": {
"maxLength": 20,
"type": "string"
},
"city": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"comment": {
"maxLength": 300,
"type": "string"
},
"entrance": {
"maxLength": 10,
"type": "string"
},
"floor": {
"maxLength": 10,
"type": "string"
},
"house": {
"maxLength": 20,
"minLength": 1,
"type": "string"
},
"intercom": {
"maxLength": 20,
"type": "string"
},
"postal_code": {
"maxLength": 20,
"type": "string"
},
"street": {
"maxLength": 150,
"minLength": 1,
"type": "string"
}
},
"required": [
"city",
"street",
"house"
],
"type": "object"
},
"external_order_ref": {
"maxLength": 255,
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"note": {
"maxLength": 500,
"type": "string"
},
"product_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"quantity": {
"exclusiveMinimum": 0,
"type": "integer"
},
"selected_options": {
"additionalProperties": {
"items": {
"pattern": "^[a-z0-9_]{1,16}$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"type": "object"
}
},
"required": [
"product_seq_id",
"quantity"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"metadata": {
"additionalProperties": {},
"type": "object"
},
"redirect_url": {
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"user_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"items",
"zone"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"cart_code": {
"maxLength": 16,
"minLength": 16,
"pattern": "^[A-Za-z0-9_-]{16}$",
"type": "string"
},
"user_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"cart_code",
"zone"
],
"type": "object"
}
]
}
}
},
"required": true
},
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"amount": {
"minLength": 1,
"type": "string"
},
"cart_version": {
"exclusiveMinimum": 0,
"type": [
"integer",
"null"
]
},
"currency": {
"enum": [
"RUB",
"USD",
"EUR",
"XTR",
"USDT",
"TON",
"BTC",
"ETH",
"LTC",
"BNB",
"TRX",
"USDC"
],
"type": "string"
},
"expires_at": {
"format": "date-time",
"type": "string"
},
"pricing_revision": {
"minLength": 1,
"type": "string"
},
"signature": {
"minLength": 1,
"type": "string"
}
},
"required": [
"cart_version",
"pricing_revision",
"amount",
"currency",
"expires_at",
"signature"
],
"type": "object"
}
}
},
"description": "Evaluate and sign an order pricing quote"
}
},
"scopes": [
"orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=quoteOrder]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "quoteOrder",
"path": "/api/v1/orders/quote",
"requestSchemaRef": "#/components/schemas/QuoteOrderRequest",
"requiredScopes": [
"orders"
],
"responseSchemaRefs": {
"201": "#/components/schemas/SignedPricingQuote",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails",
"409": "#/components/schemas/ProblemDetails",
"422": "#/components/schemas/ProblemDetails",
"503": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "quoteOrder"
}
}linkOrderUser
POST /api/v1/orders/{id}/link-user — linkOrderUser
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Malformed request or a missing Idempotency-Key header"
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing or invalid API key"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The caller lacks the orders scope or tenant access"
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Order or user was not found for this tenant"
},
"409": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The order cannot be linked or request is already in progress"
},
"422": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The requested user cannot be linked to this order"
}
},
"headers": {
"request": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {},
"404": {},
"409": {},
"422": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "linkOrderUser",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"properties": {
"user_seq_id": {
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"user_seq_id"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"example": {
"display_number": "#1042",
"items": [
{
"catalog_seq_num": 42,
"currency": "RUB",
"line_no": 1,
"quantity": 1,
"title": "Consultation",
"unit_amount": "1500.00"
}
],
"order_number": "1042",
"payment_urls": {
"yookassa": "https://pay.example.test/order/1042"
},
"seq_num": 1042,
"status": "pending",
"zone": "ru"
},
"properties": {
"display_number": {
"type": "string"
},
"items": {
"items": {
"additionalProperties": false,
"example": {
"catalog_seq_num": 42,
"currency": "RUB",
"line_no": 1,
"quantity": 1,
"title": "Consultation",
"unit_amount": "1500.00"
},
"properties": {
"catalog_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"currency": {
"maxLength": 3,
"minLength": 3,
"type": "string"
},
"description": {
"type": "string"
},
"line_no": {
"exclusiveMinimum": 0,
"type": "integer"
},
"quantity": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
},
"unit_amount": {
"type": "string"
}
},
"required": [
"line_no",
"catalog_seq_num",
"title",
"quantity",
"unit_amount",
"currency"
],
"type": "object"
},
"type": "array"
},
"order_number": {
"type": "string"
},
"payment_urls": {
"additionalProperties": {
"format": "uri",
"type": "string"
},
"type": "object"
},
"seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"status": {
"enum": [
"pending",
"paid",
"canceled",
"expired",
"linked"
],
"type": "string"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"seq_num",
"order_number",
"display_number",
"status",
"items",
"payment_urls",
"zone"
],
"type": "object"
}
}
},
"description": "Link anonymous order to user"
}
},
"scopes": [
"orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=linkOrderUser]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "linkOrderUser",
"path": "/api/v1/orders/{id}/link-user",
"requestSchemaRef": "#/components/schemas/LinkUserRequest",
"requiredScopes": [
"orders"
],
"responseSchemaRefs": {
"201": "#/components/schemas/CreateOrderResponse",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails",
"409": "#/components/schemas/ProblemDetails",
"422": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "linkOrderUser"
}
}refreshPaymentUrls
POST /api/v1/orders/{id}/refresh-payment-urls — refreshPaymentUrls
Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии.
{
"contract": {
"auth": {
"alternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"schemes": {
"hubApiKey": {
"in": "header",
"name": "X-Api-Key",
"type": "apiKey"
},
"hubBearer": {
"scheme": "bearer",
"type": "http"
}
}
},
"errors": {
"400": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Malformed request or a missing Idempotency-Key header"
},
"401": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Missing or invalid authentication"
},
"403": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "The caller lacks the orders scope or tenant access"
},
"404": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Order was not found for this tenant"
},
"409": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "A request with this Idempotency-Key is already in progress"
},
"422": {
"content": {
"application/problem+json": {
"schema": {
"properties": {
"blockingSlug": {
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$",
"type": [
"string",
"null"
]
},
"code": {
"enum": [
"INVALID_REQUEST",
"MALFORMED_JSON",
"IDEMPOTENCY_KEY_REQUIRED",
"MISSING_REQUIRED_FIELD",
"INVALID_API_VERSION",
"INVALID_PRICING_QUOTE",
"MALFORMED_IF_MATCH",
"UNAUTHORIZED",
"INVALID_API_KEY",
"INVALID_JWT",
"EXPIRED_JWT",
"INVALID_REFRESH_TOKEN",
"MFA_REQUIRED",
"FORBIDDEN",
"INSUFFICIENT_SCOPE",
"ACCOUNT_DISABLED",
"WEBHOOK_DISABLED",
"SUBSCRIPTION_INACTIVE",
"PLATFORM_OFFER_ACCEPTANCE_REQUIRED",
"NO_ACTIVE_BOT",
"PUBLISHABLE_KEY_NOT_ALLOWED",
"NOT_FOUND",
"RESOURCE_NOT_FOUND",
"SESSION_NOT_FOUND",
"ORDER_NOT_FOUND",
"USER_NOT_FOUND",
"PRODUCT_NOT_FOUND",
"PAYMENT_NOT_FOUND",
"EXPORT_NOT_FOUND",
"CART_NOT_FOUND",
"SLUG_TAKEN",
"SLUG_IMMUTABLE",
"UNPAID_BOT_LIMIT",
"ONBOARDING_BUSY",
"ONBOARDING_STEP_OUT_OF_ORDER",
"BOT_ALREADY_CONNECTED",
"BOT_RESERVED",
"SG_DISCOVERY_STALE",
"ACTIVE_SUBSCRIPTION_EXISTS",
"CONFLICT",
"IDEMPOTENCY_CONFLICT",
"IDEMPOTENCY_KEY_IN_FLIGHT",
"IDEMPOTENCY_KEY_FAILED",
"EXTERNAL_ORDER_REF_CONFLICT",
"ORDER_NOT_LINKABLE",
"SESSION_ALREADY_APPROVED",
"WEBHOOK_URL_CONFLICT",
"PRICE_CHANGED",
"ORDER_ITEM_VERSION_CONFLICT",
"ORDER_ALREADY_PAID",
"CART_INACTIVE",
"DRAFT_NOT_PENDING",
"TENANT_ARCHIVED",
"VARIANT_KEY_IMMUTABLE",
"VARIANT_KEY_REUSED",
"ORDER_NOT_REFRESHABLE",
"ORDER_ALREADY_LINKED",
"DUPLICATE_ORDER",
"SUBSCRIPTION_UPGRADE_REFUSED",
"ACQUISITION_REJECTED",
"PLATFORM_TARGET_UNRESOLVED",
"ORDER_LOCK_CONTENDED",
"SESSION_EXPIRED",
"APPROVAL_CODE_EXPIRED",
"PRECONDITION_FAILED",
"BOT_CONNECTION_NOT_READY",
"ETAG_STALE",
"ACTIVE_BOT_CHANGED",
"PREPARED_SCENARIO_TENANT_CHANGED",
"ITEM_COUNT_EXCEEDED",
"PAYLOAD_TOO_LARGE",
"SLUG_INVALID",
"INVALID_BOT_TOKEN",
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"PAYMENT_TAX_PROFILE_MISSING",
"VALIDATION_ERROR",
"IDEMPOTENCY_KEY_MISMATCH",
"ZONE_REQUIRED",
"SITE_PATH_OUTSIDE_PUBLISHABLE_PREFIX",
"INVALID_PROVIDER_CURRENCY",
"PROVIDER_NOT_CONFIGURED",
"CATALOG_FIELD_READ_ONLY",
"CATALOG_BOOKING_CONFIG_INVALID",
"CATALOG_BOOKING_RESOURCE_NOT_FOUND",
"TEXT_TOO_LONG",
"INVALID_BUTTON_CONFIG",
"INVALID_MEDIA",
"INVALID_SCOPE",
"INVALID_CURSOR",
"INVALID_FILTER",
"LIMIT_EXCEEDED",
"EXPORT_MAX_ROWS_EXCEEDED",
"TOKEN_PASSTHROUGH_FORBIDDEN",
"AUDIENCE_MISMATCH",
"INVALID_OAUTH_STATE",
"INVALID_OAUTH_REDIRECT_URI",
"ITEMS_REQUIRED",
"VARIANTS_NOT_AVAILABLE",
"INVALID_QUANTITY",
"MIXED_CURRENCY",
"NO_COMMON_PAYMENT_PROVIDER",
"SINGLETON_ORDER_REQUIRED",
"MIXED_PARTNER_RATES",
"PRODUCT_NOT_CART_ELIGIBLE",
"OPTION_UNAVAILABLE",
"QUANTITY_LIMIT",
"MERGE_REJECTED",
"BUYER_CONTACT_REQUIRED",
"DELIVERY_ADDRESS_REQUIRED",
"POSTAL_CODE_REQUIRED",
"PAYMENT_PROVIDERS_UNAVAILABLE",
"PAYMENT_LINKS_UNAVAILABLE",
"FISCAL_PROVIDER_BASIS_UNSUPPORTED",
"PRECONDITION_REQUIRED",
"PRICING_QUOTE_REQUIRED",
"ETAG_REQUIRED",
"CATALOG_UNAVAILABLE",
"CATALOG_LOCK_ORDER",
"UNSUPPORTED_QUOTE_CURRENCY",
"RATE_LIMIT_EXCEEDED",
"EXPORT_LIMIT_EXCEEDED",
"REFRESH_LIMIT_EXCEEDED",
"RATE_LIMIT_UNAVAILABLE",
"INTERNAL_ERROR",
"SERVICE_UNAVAILABLE",
"PRICING_UNAVAILABLE"
],
"type": "string"
},
"current_etag": {
"anyOf": [
{
"pattern": "^W\\/\"[a-f0-9]{16}\"$",
"type": "string"
},
{
"pattern": "^\"cart-[1-9][0-9]*\"$",
"type": "string"
}
]
},
"detail": {
"type": "string"
},
"details": {},
"hint": {
"additionalProperties": false,
"properties": {
"example": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"minLength": 1,
"type": "string"
},
"recovery": {
"minLength": 1,
"type": "string"
},
"see": {
"type": "string"
}
},
"required": [
"reason",
"recovery"
],
"type": "object"
},
"instance": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"type": "integer"
},
"title": {
"type": "string"
},
"traceId": {
"type": "string"
},
"type": {
"format": "uri",
"type": "string"
},
"validation_errors": {
"items": {
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"field",
"message",
"code"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type",
"title",
"status",
"code",
"traceId"
],
"type": "object"
}
}
},
"description": "Requested payment provider is unavailable for this order"
}
},
"headers": {
"request": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {},
"404": {},
"409": {},
"422": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "refreshPaymentUrls",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"properties": {
"payment_providers": {
"items": {
"type": "string"
},
"type": "array"
},
"redirect_url": {
"format": "uri",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Required for nonempty POST bodies; optional for an empty refresh body.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"properties": {
"payment_urls": {
"additionalProperties": {
"format": "uri",
"type": "string"
},
"type": "object"
},
"refresh_count": {
"minimum": 0,
"type": "integer"
},
"seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"seq_num",
"payment_urls",
"refresh_count"
],
"type": "object"
}
}
},
"description": "Refresh order payment URLs"
}
},
"scopes": [
"orders"
]
},
"evidence": {
"acceptanceTask": "T188",
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-session-order.json",
"implementationSha": "9456e9c121892bc2cb6664519945629c4ae8a4d4",
"registrar": "registerOrderPaths",
"result": "accepted",
"selection": "operations[operationId=refreshPaymentUrls]",
"source": "isolated accepted leaf + canonical common; primary actual-boundary fixture is independent"
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "refreshPaymentUrls",
"path": "/api/v1/orders/{id}/refresh-payment-urls",
"requestSchemaRef": "#/components/schemas/RefreshPaymentUrlsRequest",
"requiredScopes": [
"orders"
],
"responseSchemaRefs": {
"201": "#/components/schemas/RefreshPaymentUrlsResponse",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails",
"404": "#/components/schemas/ProblemDetails",
"409": "#/components/schemas/ProblemDetails",
"422": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "refreshPaymentUrls"
}
}