# REST: onboarding Source: Locale: ru releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7 sourceContentDigest: dd5d0d68990ef75236e0f978b2c058772010e33f74f51bf0dff40d0f53c67631 Version: 1 # REST: onboarding Операции этой группы относятся к текущему Hub REST-контракту. В каждой записи приведены полные request/response, ошибки, auth, scopes, headers, pagination и idempotency из принятого producer. Для requiredScopes действует ALL; между auth alternatives действует OR, внутри одной альтернативы — ALL. Пустой список scopes не отменяет указанную аутентификацию. HTTP 304 остаётся отдельным ответом без тела. Не переносите чужие лимиты или заголовки: ниже перечислены только объявленные значения данной операции. Адреса объектов и курсоры описаны в [идентификаторах](https://telegafirst.com/docs/identifiers-and-pagination), авторизация — в [руководстве](https://telegafirst.com/docs/authorization), диагностика — в [ошибках](https://telegafirst.com/docs/errors). ## getBillingState `GET /api/v1/tools/onboarding/billing` — getBillingState Контракт содержит полные разрешённые схемы, включая bodyless/binary ответы и все объявленные ошибки. Evidence указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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 указывает принятую независимую фикстуру фактической границы; это не обещание запуска в вашей сессии. ```json { "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" } } ```