Для AI-агентов: markdown этой страницы — /docs/mcp-payments.mdиндекс документации — /llms.txt
MCP: payments
Обновлено
MCP: payments
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
configure_payment_credentials
Configure (upsert) ONE payment provider for the tenant. Provide credentials — discriminated by provider (e.g. yookassa {shop_id, api_key}; stripe {secret_key, webhook_secret, currency?}) — plus optional enabled (default true) and default_currency. Credentials are stored server-side and NEVER returned by a read. Idempotent upsert on the tenant. OWNER-ONLY money-config — runs ONLY as this dedicated typed tool, never via execute_admin_action.
{
"description": "Configure (upsert) ONE payment provider for the tenant. Provide `credentials` — discriminated by `provider` (e.g. yookassa {shop_id, api_key}; stripe {secret_key, webhook_secret, currency?}) — plus optional `enabled` (default true) and `default_currency`. Credentials are stored server-side and NEVER returned by a read. Idempotent upsert on the tenant. OWNER-ONLY money-config — runs ONLY as this dedicated typed tool, never via execute_admin_action.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"credentials": {
"description": "Value for credentials.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"api_key": {
"description": "Value for api key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "yookassa",
"description": "Value for provider.",
"type": "string"
},
"shop_id": {
"description": "Value for shop id.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_id",
"api_key"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"currency": {
"description": "Value for currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "stripe",
"description": "Value for provider.",
"type": "string"
},
"secret_key": {
"description": "Value for secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"webhook_secret": {
"description": "Value for webhook secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"secret_key",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"login": {
"description": "Value for login.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"password1": {
"description": "Value for password1.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"password2": {
"description": "Value for password2.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "robokassa",
"description": "Value for provider.",
"type": "string"
},
"test_mode": {
"description": "Value for test mode.",
"type": "boolean"
}
},
"required": [
"provider",
"login",
"password1",
"password2"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"password": {
"description": "Value for password.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "tinkoff",
"description": "Value for provider.",
"type": "string"
},
"terminal_key": {
"description": "Value for terminal key.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"terminal_key",
"password"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"demo_mode": {
"description": "Value for demo mode.",
"type": "boolean"
},
"demo_secret_key": {
"description": "Value for demo secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "prodamus",
"description": "Value for provider.",
"type": "string"
},
"secret_key": {
"description": "Value for secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"shop_domain": {
"description": "Value for shop domain.",
"maxLength": 253,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_domain",
"secret_key"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"client_id": {
"description": "Value for client id.",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"client_secret": {
"description": "Value for client secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"currency": {
"description": "Value for currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"environment": {
"description": "Value for environment.",
"enum": [
"sandbox",
"production"
],
"type": "string"
},
"provider": {
"const": "paypal",
"description": "Value for provider.",
"type": "string"
},
"webhook_id": {
"description": "Value for webhook id.",
"maxLength": 256,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"environment",
"client_id",
"client_secret",
"webhook_id"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"api_key": {
"description": "Value for api key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"client_token": {
"description": "Value for client token.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"environment": {
"description": "Value for environment.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "paddle",
"description": "Value for provider.",
"type": "string"
},
"webhook_secret": {
"description": "Value for webhook secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"api_key",
"client_token",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"environment": {
"description": "Value for environment.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "cryptobot",
"description": "Value for provider.",
"type": "string"
},
"token": {
"description": "Value for token.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"token"
],
"type": "object"
}
]
},
"default_currency": {
"description": "Value for default currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"enabled": {
"description": "Value for enabled.",
"type": "boolean"
}
},
"required": [
"credentials"
],
"type": "object"
},
"name": "configure_payment_credentials",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "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",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"webhook_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": 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,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"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": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "money",
"scope": "payments:config",
"title": "Configure Payment Credentials"
}disable_payment_provider
Switch OFF one payment provider by provider (keeps the stored credentials — re-enable by reconfiguring). Idempotent — disabling an already-off/absent provider returns disabled:true. OWNER-ONLY money-config (dedicated typed tool only).
{
"description": "Switch OFF one payment provider by `provider` (keeps the stored credentials — re-enable by reconfiguring). Idempotent — disabling an already-off/absent provider returns disabled:true. OWNER-ONLY money-config (dedicated typed tool only).",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"provider": {
"description": "Value for provider.",
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"name": "disable_payment_provider",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "money",
"scope": "payments:config",
"title": "Disable Payment Provider"
}enable_payment_provider
Switch ON one payment provider by provider WITHOUT sending credentials. This is how Telegram Stars (stars) is connected — it has no secrets, so it is not part of configure_payment_credentials. Also re-arms a credentialed provider that was switched off, reusing the secrets already on file. Idempotent — enabling an already-on provider returns enabled:true. The response hasCredentials:false means the provider still needs configure_payment_credentials before checkout works. OWNER-ONLY money-config (dedicated typed tool only).
{
"description": "Switch ON one payment provider by `provider` WITHOUT sending credentials. This is how Telegram Stars (`stars`) is connected — it has no secrets, so it is not part of configure_payment_credentials. Also re-arms a credentialed provider that was switched off, reusing the secrets already on file. Idempotent — enabling an already-on provider returns enabled:true. The response `hasCredentials:false` means the provider still needs configure_payment_credentials before checkout works. OWNER-ONLY money-config (dedicated typed tool only).",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"provider": {
"description": "Value for provider.",
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"name": "enable_payment_provider",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "money",
"scope": "payments:config",
"title": "Enable Payment Provider"
}get_payment_config
Read the tenant payment-provider config: each of the 9 providers (yookassa / stripe / robokassa / tinkoff / prodamus / paypal / paddle / cryptobot / stars) with enabled, hasCredentials (whether a secret is on file — the secret itself is NEVER returned) and currency, plus the tenant defaultCurrency. OWNER-ONLY. 0-cost read.
{
"description": "Read the tenant payment-provider config: each of the 9 providers (yookassa / stripe / robokassa / tinkoff / prodamus / paypal / paddle / cryptobot / stars) with `enabled`, `hasCredentials` (whether a secret is on file — the secret itself is NEVER returned) and `currency`, plus the tenant `defaultCurrency`. OWNER-ONLY. 0-cost read.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_payment_config",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "read",
"scope": "payments:config",
"title": "Get Payment Config"
}list_payment_rows
List payment records for the current tenant. Each record is addressed by its tenant-scoped seqNum and references customers and orders by their sequence numbers. This reads payments, not payment-provider configuration.
{
"description": "List payment records for the current tenant. Each record is addressed by its tenant-scoped `seqNum` and references customers and orders by their sequence numbers. This reads payments, not payment-provider configuration.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"after_seq_num": {
"description": "Value for after seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"limit": {
"description": "Value for limit.",
"exclusiveMinimum": 0,
"maximum": 100,
"type": "integer"
}
},
"type": "object"
},
"name": "list_payment_rows",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"payments"
],
"risk": "read",
"scope": "payments",
"title": "List Payment Rows"
}onboarding_check_payment_provider
Verify the current payment configuration and return specific remaining requirements.
{
"description": "Verify the current payment configuration and return specific remaining requirements.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"provider": {
"description": "Value for provider.",
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"name": "onboarding_check_payment_provider",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "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",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"webhook_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": 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,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"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": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "write",
"scope": "payments:config",
"title": "Onboarding Check Payment Provider"
}onboarding_confirm_payment_webhook
After the owner reviews the exact provider configuration, record their explicit webhook setup confirmation. This is owner attestation, not verification of a live callback.
{
"description": "After the owner reviews the exact provider configuration, record their explicit webhook setup confirmation. This is owner attestation, not verification of a live callback.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"configuration_confirmation_token": {
"description": "Value for configuration confirmation token.",
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"provider": {
"description": "Value for provider.",
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_confirmation_token"
],
"type": "object"
},
"name": "onboarding_confirm_payment_webhook",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "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",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"webhook_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": 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,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"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": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "money",
"scope": "payments:config",
"title": "Onboarding Confirm Payment Webhook"
}onboarding_connect_payment_provider
Save the selected payment provider configuration and verify readiness without charging the owner.
{
"description": "Save the selected payment provider configuration and verify readiness without charging the owner.",
"domain": "payments",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"anyOf": [
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"credentials": {
"description": "Value for credentials.",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"api_key": {
"description": "Value for api key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "yookassa",
"description": "Value for provider.",
"type": "string"
},
"shop_id": {
"description": "Value for shop id.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_id",
"api_key"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"currency": {
"description": "Value for currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "stripe",
"description": "Value for provider.",
"type": "string"
},
"secret_key": {
"description": "Value for secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"webhook_secret": {
"description": "Value for webhook secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"secret_key",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"login": {
"description": "Value for login.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"password1": {
"description": "Value for password1.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"password2": {
"description": "Value for password2.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "robokassa",
"description": "Value for provider.",
"type": "string"
},
"test_mode": {
"description": "Value for test mode.",
"type": "boolean"
}
},
"required": [
"provider",
"login",
"password1",
"password2"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"password": {
"description": "Value for password.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "tinkoff",
"description": "Value for provider.",
"type": "string"
},
"terminal_key": {
"description": "Value for terminal key.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"terminal_key",
"password"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"demo_mode": {
"description": "Value for demo mode.",
"type": "boolean"
},
"demo_secret_key": {
"description": "Value for demo secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "prodamus",
"description": "Value for provider.",
"type": "string"
},
"secret_key": {
"description": "Value for secret key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"shop_domain": {
"description": "Value for shop domain.",
"maxLength": 253,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"shop_domain",
"secret_key"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"client_id": {
"description": "Value for client id.",
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"client_secret": {
"description": "Value for client secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"currency": {
"description": "Value for currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"environment": {
"description": "Value for environment.",
"enum": [
"sandbox",
"production"
],
"type": "string"
},
"provider": {
"const": "paypal",
"description": "Value for provider.",
"type": "string"
},
"webhook_id": {
"description": "Value for webhook id.",
"maxLength": 256,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"environment",
"client_id",
"client_secret",
"webhook_id"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"api_key": {
"description": "Value for api key.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"client_token": {
"description": "Value for client token.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"environment": {
"description": "Value for environment.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "paddle",
"description": "Value for provider.",
"type": "string"
},
"webhook_secret": {
"description": "Value for webhook secret.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"api_key",
"client_token",
"webhook_secret"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for credentials option.",
"properties": {
"environment": {
"description": "Value for environment.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"provider": {
"const": "cryptobot",
"description": "Value for provider.",
"type": "string"
},
"token": {
"description": "Value for token.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
}
},
"required": [
"provider",
"token"
],
"type": "object"
}
]
},
"default_currency": {
"description": "Value for default currency.",
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"enabled": {
"description": "Value for enabled.",
"type": "boolean"
}
},
"required": [
"credentials"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"credentials": {
"additionalProperties": false,
"description": "Value for credentials.",
"properties": {
"provider": {
"const": "stars",
"description": "Value for provider.",
"type": "string"
}
},
"required": [
"provider"
],
"type": "object"
},
"default_currency": {
"const": "XTR",
"description": "Value for default currency.",
"type": "string"
},
"enabled": {
"description": "Value for enabled.",
"type": "boolean"
}
},
"required": [
"credentials"
],
"type": "object"
}
]
},
"name": "onboarding_connect_payment_provider",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "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",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"webhook_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"provider",
"alive",
"test_mode",
"webhook_url"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": 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,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "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": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "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"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"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": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "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": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"payments:config"
],
"risk": "write",
"scope": "payments:config",
"title": "Onboarding Connect Payment Provider"
}