Для AI-агентов: markdown этой страницы — /docs/api-onboarding.mdиндекс документации — /llms.txt
REST: onboarding
Обновлено
REST: onboarding
Операции этой группы относятся к текущему Hub REST-контракту. В каждой записи приведены полные request/response, ошибки, auth, scopes, headers, pagination и idempotency из принятого producer. Для requiredScopes действует ALL; между auth alternatives действует OR, внутри одной альтернативы — ALL. Пустой список scopes не отменяет указанную аутентификацию. HTTP 304 остаётся отдельным ответом без тела. Не переносите чужие лимиты или заголовки: ниже перечислены только объявленные значения данной операции. Адреса объектов и курсоры описаны в идентификаторах, авторизация — в руководстве, диагностика — в ошибках.
getBillingState
GET /api/v1/tools/onboarding/billing — getBillingState
Контракт содержит полные разрешённые схемы, включая 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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "getBillingState",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": []
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Current billing state and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=getBillingState]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getBillingState",
"path": "/api/v1/tools/onboarding/billing",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "getBillingState"
}
}getCatalogTopicLink
GET /api/v1/tools/onboarding/catalog-topic-link — getCatalogTopicLink
Контракт содержит полные разрешённые схемы, включая 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": "Authentication required."
},
"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": "Tenant workspace or onboarding read scope refused."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "getCatalogTopicLink",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": []
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"deeplink": {
"type": [
"string",
"null"
]
},
"detail": {
"type": "string"
}
},
"required": [
"deeplink",
"detail"
],
"type": "object"
}
}
},
"description": "Settings Telegram supergroup Catalog topic link or setup hint"
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=getCatalogTopicLink]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getCatalogTopicLink",
"path": "/api/v1/tools/onboarding/catalog-topic-link",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "getCatalogTopicLink"
}
}getExistingBotInstructions
GET /api/v1/tools/onboarding/existing-bot/instructions — getExistingBotInstructions
Контракт содержит полные разрешённые схемы, включая 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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "getExistingBotInstructions",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": []
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"platform_bot_username": {
"type": "string"
}
},
"required": [
"platform_bot_username"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Confirmed selected-business state and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=getExistingBotInstructions]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getExistingBotInstructions",
"path": "/api/v1/tools/onboarding/existing-bot/instructions",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "getExistingBotInstructions"
}
}checkTestProduct
GET /api/v1/tools/onboarding/quest-product/check — checkTestProduct
Контракт содержит полные разрешённые схемы, включая 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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "checkTestProduct",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": []
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"delivery_state": {
"enum": [
"pending",
"ready",
"failed"
],
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": [
"integer",
"null"
]
},
"ready": {
"type": "boolean"
}
},
"required": [
"product_seq_num",
"ready",
"delivery_state"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Confirmed selected-business state and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=checkTestProduct]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "checkTestProduct",
"path": "/api/v1/tools/onboarding/quest-product/check",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "checkTestProduct"
}
}checkTestPurchase
GET /api/v1/tools/onboarding/quest-purchase/check — checkTestPurchase
Контракт содержит полные разрешённые схемы, включая 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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "checkTestPurchase",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": []
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"tokens_granted": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"completed",
"bonus_state",
"tokens_granted"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Confirmed selected-business state and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=checkTestPurchase]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "checkTestPurchase",
"path": "/api/v1/tools/onboarding/quest-purchase/check",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "checkTestPurchase"
}
}checkSlugAvailability
GET /api/v1/tools/onboarding/slug-availability — checkSlugAvailability
Контракт содержит полные разрешённые схемы, включая 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": "A bounded address string is required."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "checkSlugAvailability",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"in": "query",
"name": "slug",
"required": true,
"schema": {
"maxLength": 63,
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"reason": {
"enum": [
"format",
"reserved"
],
"type": "string"
},
"slug": {
"maxLength": 63,
"type": "string"
},
"status": {
"enum": [
"free",
"taken",
"invalid",
"owned"
],
"type": "string"
}
},
"required": [
"slug",
"status"
],
"type": "object"
}
}
},
"description": "Authorized availability read; atomic claim is the final authority."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=checkSlugAvailability]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "checkSlugAvailability",
"path": "/api/v1/tools/onboarding/slug-availability",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "checkSlugAvailability"
}
}getOnboardingState
GET /api/v1/tools/onboarding/state — getOnboardingState
Контракт содержит полные разрешённые схемы, включая 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 onboarding entry intent or unknown query field."
},
"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": "Authentication required."
},
"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": "Onboarding read scope required."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "getOnboardingState",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"in": "query",
"name": "intent",
"required": false,
"schema": {
"default": "auto",
"enum": [
"auto",
"new_business"
],
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"type": [
"string",
"null"
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": [
"object",
"null"
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": [
"object",
"null"
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"enum": [
"owner"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"additionalProperties": false,
"properties": {
"blocked_reason": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability",
null
],
"type": [
"string",
"null"
]
},
"bots_report": {
"additionalProperties": false,
"properties": {
"observed_cap": {
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": [
"object",
"null"
]
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"pins_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
},
"sa_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": [
"object",
"null"
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": [
"object",
"null"
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"format": "uri",
"type": [
"string",
"null"
]
},
"tariffs": {
"format": "uri",
"type": [
"string",
"null"
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED",
null
],
"type": [
"string",
"null"
]
},
"generation": {
"enum": [
0
],
"type": "number"
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": [
"object",
"null"
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": [
"object",
"null"
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"enum": [
"RUB"
],
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding state and next action; intent defaults to auto. For a human, entry_context distinguishes the active business, owned candidates and recommended action without switching the active pointer. new_business requests personal creation guidance and is refused for API-key/M2M credentials. No tenant selector is accepted."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=getOnboardingState]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "getOnboardingState",
"path": "/api/v1/tools/onboarding/state",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "getOnboardingState"
}
}discoverSupergroups
GET /api/v1/tools/onboarding/supergroups/discovery — discoverSupergroups
Контракт содержит полные разрешённые схемы, включая 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 refresh value."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [],
"response": {
"200": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "none",
"parameters": []
},
"operationId": "discoverSupergroups",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"in": "query",
"name": "refresh",
"required": false,
"schema": {
"enum": [
"0",
"1"
],
"type": "string"
}
}
]
},
"response": {
"200": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Discovered operator groups and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=discoverSupergroups]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "get",
"operationId": "discoverSupergroups",
"path": "/api/v1/tools/onboarding/supergroups/discovery",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"200": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
200
],
"title": "discoverSupergroups"
}
}saveAiPreferences
POST /api/v1/tools/onboarding/ai-preferences — saveAiPreferences
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "saveAiPreferences",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
}
},
"required": [
"preferences"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=saveAiPreferences]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "saveAiPreferences",
"path": "/api/v1/tools/onboarding/ai-preferences",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "saveAiPreferences"
}
}cancelAutoRenew
POST /api/v1/tools/onboarding/billing/cancel-auto-renew — cancelAutoRenew
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "cancelAutoRenew",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=cancelAutoRenew]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "cancelAutoRenew",
"path": "/api/v1/tools/onboarding/billing/cancel-auto-renew",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "cancelAutoRenew"
}
}sendTariffCheckoutCard
POST /api/v1/tools/onboarding/billing/checkout-card — sendTariffCheckoutCard
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "sendTariffCheckoutCard",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
}
},
"required": [
"plan"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"bot_username": {
"pattern": "^[A-Za-z0-9_]{5,32}$",
"type": "string"
},
"card_delivery_state": {
"enum": [
"pending",
"sent"
],
"type": "string"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
}
},
"required": [
"plan",
"card_delivery_state",
"bot_username"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=sendTariffCheckoutCard]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "sendTariffCheckoutCard",
"path": "/api/v1/tools/onboarding/billing/checkout-card",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "sendTariffCheckoutCard"
}
}deferTariff
POST /api/v1/tools/onboarding/billing/defer — deferTariff
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "deferTariff",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
}
},
"required": [
"decisions"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=deferTariff]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "deferTariff",
"path": "/api/v1/tools/onboarding/billing/defer",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "deferTariff"
}
}resumeBotConnection
POST /api/v1/tools/onboarding/bot-connection/resume — resumeBotConnection
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "resumeBotConnection",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"connected": {
"enum": [
true
],
"type": "boolean"
}
},
"required": [
"connected"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=resumeBotConnection]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "resumeBotConnection",
"path": "/api/v1/tools/onboarding/bot-connection/resume",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "resumeBotConnection"
}
}connectChannel
POST /api/v1/tools/onboarding/channel/connect — connectChannel
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "connectChannel",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"bot_token": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"channel": {
"enum": [
"max"
],
"type": "string"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"channel",
"bot_token",
"idempotency_key"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"access_token": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"channel": {
"enum": [
"vk"
],
"type": "string"
},
"group_id": {
"exclusiveMinimum": 0,
"type": "integer"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"channel",
"access_token",
"group_id",
"idempotency_key"
],
"type": "object"
}
]
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"channel": {
"enum": [
"max",
"vk"
],
"type": "string"
},
"operation_key": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"reason": {
"enum": [
"credentials_invalid",
"registration_failed",
"reconciliation_required"
],
"type": "string"
},
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"status": {
"enum": [
"pending",
"ready",
"failed"
],
"type": "string"
}
},
"required": [
"channel",
"status",
"operation_key"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"client-config:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=connectChannel]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "connectChannel",
"path": "/api/v1/tools/onboarding/channel/connect",
"requestSchemaRef": null,
"requiredScopes": [
"client-config:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "connectChannel"
}
}completeOnboarding
POST /api/v1/tools/onboarding/complete — completeOnboarding
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "completeOnboarding",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"confirm": {
"enum": [
true
],
"type": "boolean"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
}
},
"required": [
"confirm",
"questions_revision"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"completed": {
"enum": [
true
],
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": "string"
}
},
"required": [
"completed",
"completed_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=completeOnboarding]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "completeOnboarding",
"path": "/api/v1/tools/onboarding/complete",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "completeOnboarding"
}
}registerExistingBot
POST /api/v1/tools/onboarding/existing-bot — registerExistingBot
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "registerExistingBot",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"bot_token": {
"maxLength": 59,
"minLength": 44,
"pattern": "^(\\d{8,12}):([A-Za-z0-9_-]{35,46})$",
"type": "string"
}
},
"required": [
"bot_token"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"connected": {
"enum": [
true
],
"type": "boolean"
}
},
"required": [
"connected"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=registerExistingBot]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "registerExistingBot",
"path": "/api/v1/tools/onboarding/existing-bot",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "registerExistingBot"
}
}deferFirstPayment
POST /api/v1/tools/onboarding/first-payment/defer — deferFirstPayment
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "deferFirstPayment",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
}
},
"required": [
"decisions"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=deferFirstPayment]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "deferFirstPayment",
"path": "/api/v1/tools/onboarding/first-payment/defer",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "deferFirstPayment"
}
}executeFirstPayment
POST /api/v1/tools/onboarding/first-payment/execute — executeFirstPayment
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "executeFirstPayment",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"preparation_id",
"payload_hash"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"card_delivery_state": {
"enum": [
"pending",
"sent"
],
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"product_seq_num",
"title",
"card_delivery_state"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"catalog:write",
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=executeFirstPayment]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "executeFirstPayment",
"path": "/api/v1/tools/onboarding/first-payment/execute",
"requestSchemaRef": null,
"requiredScopes": [
"catalog:write",
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "executeFirstPayment"
}
}prepareFirstPayment
POST /api/v1/tools/onboarding/first-payment/prepare — prepareFirstPayment
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "prepareFirstPayment",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"product_seq_num",
"provider",
"amount",
"currency"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"expires_at": {
"format": "date-time",
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"product_seq_num",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash",
"expires_at",
"title"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"catalog:write",
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=prepareFirstPayment]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "prepareFirstPayment",
"path": "/api/v1/tools/onboarding/first-payment/prepare",
"requestSchemaRef": null,
"requiredScopes": [
"catalog:write",
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "prepareFirstPayment"
}
}checkFreeConditions
POST /api/v1/tools/onboarding/free-conditions/check — checkFreeConditions
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "checkFreeConditions",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": null,
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"applies_now": {
"type": "boolean"
},
"bot_not_blocked": {
"type": "boolean"
},
"subscribed": {
"type": "boolean"
}
},
"required": [
"subscribed",
"bot_not_blocked",
"applies_now"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:read"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=checkFreeConditions]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "checkFreeConditions",
"path": "/api/v1/tools/onboarding/free-conditions/check",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:read"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "checkFreeConditions"
}
}resumeInfrastructure
POST /api/v1/tools/onboarding/infrastructure/resume — resumeInfrastructure
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "resumeInfrastructure",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"type": [
"string",
"null"
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": [
"object",
"null"
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": [
"object",
"null"
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"enum": [
"owner"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"additionalProperties": false,
"properties": {
"blocked_reason": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability",
null
],
"type": [
"string",
"null"
]
},
"bots_report": {
"additionalProperties": false,
"properties": {
"observed_cap": {
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": [
"object",
"null"
]
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"pins_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
},
"sa_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": [
"object",
"null"
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": [
"object",
"null"
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"format": "uri",
"type": [
"string",
"null"
]
},
"tariffs": {
"format": "uri",
"type": [
"string",
"null"
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED",
null
],
"type": [
"string",
"null"
]
},
"generation": {
"enum": [
0
],
"type": "number"
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": [
"object",
"null"
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": [
"object",
"null"
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"enum": [
"RUB"
],
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=resumeInfrastructure]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "resumeInfrastructure",
"path": "/api/v1/tools/onboarding/infrastructure/resume",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "resumeInfrastructure"
}
}initManagedBot
POST /api/v1/tools/onboarding/managed-bot — initManagedBot
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "initManagedBot",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": false,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"deeplink": {
"type": "string"
},
"suggested_name": {
"type": "string"
},
"suggested_username": {
"type": "string"
}
},
"required": [
"deeplink",
"suggested_username",
"suggested_name"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=initManagedBot]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "initManagedBot",
"path": "/api/v1/tools/onboarding/managed-bot",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "initManagedBot"
}
}registerMiniAppOrigin
POST /api/v1/tools/onboarding/mini-app-origin — registerMiniAppOrigin
Контракт содержит полные разрешённые схемы, включая 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": "Request body failed validation — a non-HTTPS origin, an unknown zone, or a smuggled tenant id."
},
"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, revoked, or expired Hub credential."
},
"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 authenticated credential lacks the onboarding:write scope."
}
},
"headers": {
"request": [
{
"description": "Required for the nonempty canonical Mini App registration request.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Required for the nonempty canonical Mini App registration request.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "registerMiniAppOrigin",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"description": "HTTPS URL/origin only; the actual canonical validator preserves its HTTPS refinement.",
"properties": {
"origin": {
"format": "uri",
"type": "string"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"zone",
"origin"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Required for the nonempty canonical Mini App registration request.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"properties": {
"channel": {
"enum": [
"telegram"
],
"type": "string"
},
"idempotent": {
"type": "boolean"
},
"origin": {
"type": "string"
},
"status": {
"enum": [
"registered"
],
"type": "string"
},
"zone": {
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"channel",
"zone",
"origin",
"status",
"idempotent"
],
"type": "object"
}
}
},
"description": "Owner-confirmed Mini App origin recorded; no Bot API mutation occurs (ADR-076 / ADR-149)."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=registerMiniAppOrigin]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "registerMiniAppOrigin",
"path": "/api/v1/tools/onboarding/mini-app-origin",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": "#/components/schemas/MiniAppOriginRegistration",
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "registerMiniAppOrigin"
}
}checkPaymentProvider
POST /api/v1/tools/onboarding/payment-provider/check — checkPaymentProvider
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "checkPaymentProvider",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"alive": {
"type": "boolean"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
"test_mode": {
"type": [
"boolean",
"null"
]
},
"webhook_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=checkPaymentProvider]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "checkPaymentProvider",
"path": "/api/v1/tools/onboarding/payment-provider/check",
"requestSchemaRef": null,
"requiredScopes": [
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "checkPaymentProvider"
}
}connectPaymentProvider
POST /api/v1/tools/onboarding/payment-provider/connect — connectPaymentProvider
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "connectPaymentProvider",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"credentials": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"api_key": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"yookassa"
],
"type": "string"
},
"shop_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_id",
"api_key"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"stripe"
],
"type": "string"
},
"secret_key": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"webhook_secret": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"secret_key",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"login": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"password1": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"password2": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"robokassa"
],
"type": "string"
},
"test_mode": {
"type": "boolean"
}
},
"required": [
"provider",
"login",
"password1",
"password2"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"password": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"tinkoff"
],
"type": "string"
},
"terminal_key": {
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"terminal_key",
"password"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"demo_mode": {
"type": "boolean"
},
"demo_secret_key": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"prodamus"
],
"type": "string"
},
"secret_key": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"shop_domain": {
"maxLength": 253,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_domain",
"secret_key"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"client_id": {
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"client_secret": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"environment": {
"enum": [
"sandbox",
"production"
],
"type": "string"
},
"provider": {
"enum": [
"paypal"
],
"type": "string"
},
"webhook_id": {
"maxLength": 256,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"environment",
"client_id",
"client_secret",
"webhook_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"api_key": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"client_token": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"environment": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"paddle"
],
"type": "string"
},
"webhook_secret": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"api_key",
"client_token",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"environment": {
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"enum": [
"cryptobot"
],
"type": "string"
},
"token": {
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"token"
],
"type": "object"
}
]
},
"default_currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"enabled": {
"type": "boolean"
}
},
"required": [
"credentials"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"credentials": {
"additionalProperties": false,
"properties": {
"provider": {
"enum": [
"stars"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"default_currency": {
"enum": [
"XTR"
],
"type": "string"
},
"enabled": {
"type": "boolean"
}
},
"required": [
"credentials"
],
"type": "object"
}
]
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"alive": {
"type": "boolean"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
"test_mode": {
"type": [
"boolean",
"null"
]
},
"webhook_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=connectPaymentProvider]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "connectPaymentProvider",
"path": "/api/v1/tools/onboarding/payment-provider/connect",
"requestSchemaRef": null,
"requiredScopes": [
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "connectPaymentProvider"
}
}probePaymentProvider
POST /api/v1/tools/onboarding/payment-provider/probe — probePaymentProvider
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "probePaymentProvider",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"alive": {
"type": "boolean"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
"test_mode": {
"type": [
"boolean",
"null"
]
},
"webhook_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=probePaymentProvider]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "probePaymentProvider",
"path": "/api/v1/tools/onboarding/payment-provider/probe",
"requestSchemaRef": null,
"requiredScopes": [
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "probePaymentProvider"
}
}confirmPaymentWebhook
POST /api/v1/tools/onboarding/payment-provider/webhook/confirm — confirmPaymentWebhook
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "confirmPaymentWebhook",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_confirmation_token"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"alive": {
"type": "boolean"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
"test_mode": {
"type": [
"boolean",
"null"
]
},
"webhook_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"payments:config"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=confirmPaymentWebhook]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "confirmPaymentWebhook",
"path": "/api/v1/tools/onboarding/payment-provider/webhook/confirm",
"requestSchemaRef": null,
"requiredScopes": [
"payments:config"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "confirmPaymentWebhook"
}
}createQuestProduct
POST /api/v1/tools/onboarding/quest-product — createQuestProduct
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "createQuestProduct",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"card": {
"additionalProperties": false,
"properties": {
"mediaRefs": {
"default": [],
"description": "Immutable descriptors from media_finalize. URLs and bytes are forbidden.",
"items": {
"additionalProperties": false,
"properties": {
"caption": {
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"items": {
"additionalProperties": false,
"properties": {
"custom_emoji_id": {
"type": "string"
},
"language": {
"type": "string"
},
"length": {
"exclusiveMinimum": 0,
"type": "integer"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"type": "string"
},
"user": {
"additionalProperties": false,
"properties": {
"firstName": {
"type": "string"
},
"id": {
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"type": "string"
},
"username": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"text": {
"anyOf": [
{
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"type": "object"
},
"delivery": {
"additionalProperties": false,
"properties": {
"mediaRefs": {
"default": [],
"description": "Immutable descriptors from media_finalize. URLs and bytes are forbidden.",
"items": {
"additionalProperties": false,
"properties": {
"caption": {
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"items": {
"additionalProperties": false,
"properties": {
"custom_emoji_id": {
"type": "string"
},
"language": {
"type": "string"
},
"length": {
"exclusiveMinimum": 0,
"type": "integer"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"type": "string"
},
"user": {
"additionalProperties": false,
"properties": {
"firstName": {
"type": "string"
},
"id": {
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"type": "string"
},
"username": {
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"text": {
"anyOf": [
{
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
{
"enum": [
""
],
"type": "string"
}
]
}
},
"type": "object"
},
"idempotency_key": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"journey_revision": {
"enum": [
1
],
"type": "number"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"card",
"delivery",
"idempotency_key",
"journey_revision"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"delivery_state": {
"enum": [
"pending",
"ready",
"failed"
],
"type": "string"
},
"phase": {
"enum": [
"accepted",
"card_pending",
"delivery_pending",
"ready",
"failed"
],
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": [
"integer",
"null"
]
},
"title": {
"type": "string"
}
},
"required": [
"product_seq_num",
"title",
"delivery_state"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=createQuestProduct]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "createQuestProduct",
"path": "/api/v1/tools/onboarding/quest-product",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "createQuestProduct"
}
}createQuickSite
POST /api/v1/tools/onboarding/quick-site — createQuickSite
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "createQuickSite",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"oneOf": [
{
"required": [
"text"
]
},
{
"required": [
"fields"
]
}
],
"properties": {
"fields": {
"additionalProperties": false,
"properties": {
"avatar_media_ref": {
"description": "Durable public HTTPS business image URL; opaque references and signed expiring URLs are not accepted",
"format": "uri",
"type": "string"
},
"business_name": {
"description": "Business name",
"type": "string"
},
"contacts": {
"description": "Business contact methods",
"items": {
"additionalProperties": false,
"properties": {
"kind": {
"description": "Contact method",
"enum": [
"phone",
"email",
"telegram",
"url"
],
"type": "string"
},
"value": {
"description": "Contact value",
"type": "string"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
"type": "array"
},
"offer": {
"description": "What the business offers",
"type": "string"
},
"tagline": {
"description": "Short business description",
"type": "string"
}
},
"required": [
"business_name",
"offer",
"contacts"
],
"type": "object"
},
"text": {
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"fallback_to_fields": {
"type": "boolean"
},
"published": {
"type": "boolean"
},
"site_url": {
"type": [
"string",
"null"
]
}
},
"required": [
"published",
"site_url",
"fallback_to_fields"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=createQuickSite]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "createQuickSite",
"path": "/api/v1/tools/onboarding/quick-site",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "createQuickSite"
}
}retryOnboardingSite
POST /api/v1/tools/onboarding/site/retry — retryOnboardingSite
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "retryOnboardingSite",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {},
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"type": [
"string",
"null"
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": [
"object",
"null"
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": [
"object",
"null"
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"enum": [
"owner"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"additionalProperties": false,
"properties": {
"blocked_reason": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability",
null
],
"type": [
"string",
"null"
]
},
"bots_report": {
"additionalProperties": false,
"properties": {
"observed_cap": {
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": [
"object",
"null"
]
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"pins_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
},
"sa_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": [
"object",
"null"
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"minimum": 0,
"type": "integer"
},
"created": {
"minimum": 0,
"type": "integer"
},
"expected": {
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": [
"object",
"null"
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": [
"object",
"null"
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"format": "uri",
"type": [
"string",
"null"
]
},
"tariffs": {
"format": "uri",
"type": [
"string",
"null"
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED",
null
],
"type": [
"string",
"null"
]
},
"generation": {
"enum": [
0
],
"type": "number"
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": [
"object",
"null"
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": [
"object",
"null"
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": [
"string",
"null"
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"enum": [
"RUB"
],
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Saved automatic operation retried idempotently. Poll state for persisted phases and final result."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=retryOnboardingSite]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "retryOnboardingSite",
"path": "/api/v1/tools/onboarding/site/retry",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "retryOnboardingSite"
}
}claimSlug
POST /api/v1/tools/onboarding/slug — claimSlug
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "claimSlug",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"new_business": {
"type": "boolean"
},
"slug": {
"maxLength": 63,
"minLength": 1,
"type": "string"
},
"src": {
"maxLength": 64,
"pattern": "^[a-z0-9_-]+$",
"type": "string"
}
},
"required": [
"slug",
"language"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"site_operation": {
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED",
null
],
"type": [
"string",
"null"
]
},
"generation": {
"enum": [
0
],
"type": "number"
},
"next_attempt_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": [
"object",
"null"
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": [
"object",
"null"
]
},
"site_url": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"language",
"site_url",
"site_operation"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Immutable address claimed and automatic site operation started or replayed. Poll state for persisted phases and the final two-zone bio result; no first-site questionnaire is required."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=claimSlug]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "claimSlug",
"path": "/api/v1/tools/onboarding/slug",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "claimSlug"
}
}confirmSupergroups
POST /api/v1/tools/onboarding/supergroups/confirm — confirmSupergroups
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "confirmSupergroups",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"roles": {
"additionalProperties": false,
"properties": {
"open_lines": {
"exclusiveMinimum": 0,
"type": "integer"
},
"operations": {
"exclusiveMinimum": 0,
"type": "integer"
},
"settings": {
"exclusiveMinimum": 0,
"type": "integer"
}
},
"required": [
"settings",
"operations",
"open_lines"
],
"type": "object"
}
},
"required": [
"fingerprint",
"roles"
],
"type": "object"
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"accepted": {
"enum": [
true
],
"type": "boolean"
}
},
"required": [
"accepted"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=confirmSupergroups]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "confirmSupergroups",
"path": "/api/v1/tools/onboarding/supergroups/confirm",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "confirmSupergroups"
}
}setTaxProfile
POST /api/v1/tools/onboarding/tax-profile — setTaxProfile
Контракт содержит полные разрешённые схемы, включая 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 input or missing idempotency key."
},
"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": "Authentication required."
},
"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": "Operation is not permitted."
}
},
"headers": {
"request": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"response": {
"201": {},
"400": {},
"401": {},
"403": {}
}
},
"idempotency": {
"boundary": null,
"contract": "http-cache",
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"operationId": "setTaxProfile",
"pagination": {
"contract": null,
"parameters": []
},
"request": {
"body": {
"content": {
"application/json": {
"schema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"business_type": {
"enum": [
"ip"
],
"type": "string"
},
"jurisdiction": {
"enum": [
"ru"
],
"type": "string"
},
"taxation_system": {
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent"
],
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type",
"taxation_system"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"business_type": {
"enum": [
"ooo"
],
"type": "string"
},
"jurisdiction": {
"enum": [
"ru"
],
"type": "string"
},
"taxation_system": {
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent"
],
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type",
"taxation_system"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"business_type": {
"enum": [
"self_employed"
],
"type": "string"
},
"jurisdiction": {
"enum": [
"ru"
],
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type"
],
"type": "object"
}
]
}
}
},
"required": true
},
"parameters": [
{
"description": "Canonical global response cache requires a key for a nonempty body; journey commands, direct bot connection, retry, tax, provider and billing cancellation also enforce it in the actual controller. Bot connection recovery uses its durable tenant reservation and accepts an empty body without a key.",
"in": "header",
"name": "Idempotency-Key",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
]
},
"response": {
"201": {
"content": {
"application/json": {
"schema": {
"additionalProperties": false,
"properties": {
"active_slug": {
"type": [
"string",
"null"
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"type": "string"
},
"next_charge_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"period_end": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"trial_started_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"business_type": {
"enum": [
"ip",
"ooo",
"self_employed"
],
"type": "string"
},
"taxation_system": {
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent",
null
],
"type": [
"string",
"null"
]
}
},
"required": [
"business_type",
"taxation_system"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"enum": [
1
],
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": [
"object",
"null"
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
},
"tariff_deferred_at": {
"format": "date-time",
"type": [
"string",
"null"
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"enum": [
true
],
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"type": [
"string",
"null"
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": [
"object",
"null"
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"pattern": "^[a-f0-9]{64}$",
"type": [
"string",
"null"
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"type": [
"string",
"null"
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"enum": [
"provider_api",
"signed_delivery",
"owner_attested",
null
],
"type": [
"string",
"null"
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": [
"object",
"null"
]
},
"revision": {
"enum": [
1
],
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"business_slug": {
"type": [
"string",
"null"
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"enum": [
"get_onboarding_state"
],
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"enum": [
"preparation_id"
],
"type": "string"
},
{
"enum": [
"payload_hash"
],
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"enum": [
true
],
"type": "boolean"
},
"tool": {
"enum": [
"onboarding_execute_first_payment"
],
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": [
"object",
"null"
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"minLength": 1,
"type": [
"string",
"null"
]
},
"wait": {
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": [
"object",
"null"
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"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"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"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": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
}
}
},
"description": "Onboarding result and next action."
}
},
"scopes": [
"onboarding:write"
]
},
"evidence": {
"executionReceipt": {
"durationSeconds": 22.39,
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"logSha256": "3caa4ff1f0d663012aff95a9d9bf4ef0ff2e8903bf10e90e8f57b91f7d638d53",
"scope": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance.",
"status": "executed_pass",
"suite": "onboarding controller, independent wire values, OpenAPI paths and idempotency",
"testsFailed": 0,
"testsPassed": 326
},
"fixture": "apps/external-hub/src/__tests__/fixtures/public-rest/values-onboarding.json",
"implementationSha": "bff3da129f2da5162879014b5993d38e3ca3adfa",
"registrar": "registerOnboardingPaths",
"result": "accepted",
"selection": "operations[operationId=setTaxProfile]",
"source": "Composed real controllers/surface/guards/interceptors with mocked storage and external IO. Not native delivery, provider, real DB, browser or model-host acceptance."
},
"operation": {
"authAlternatives": [
{
"hubApiKey": []
},
{
"hubBearer": []
}
],
"method": "post",
"operationId": "setTaxProfile",
"path": "/api/v1/tools/onboarding/tax-profile",
"requestSchemaRef": null,
"requiredScopes": [
"onboarding:write"
],
"responseSchemaRefs": {
"201": null,
"400": "#/components/schemas/ProblemDetails",
"401": "#/components/schemas/ProblemDetails",
"403": "#/components/schemas/ProblemDetails"
},
"successStatuses": [
201
],
"title": "setTaxProfile"
}
}