# MCP: payments

Source: <https://telegafirst.com/docs/mcp-payments>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 8b31e99dbe67d7c371fa890833b4ff032d97517cebf88df663d8586264c14908
Version: 9

# MCP: payments

Определения инструментов. Обновляйте tools/list после изменения прав. required\_scopes: ALL.

## 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.

Scopes (ALL): \["payments:config"]. Risk: "money".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-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).

Scopes (ALL): \["payments:config"]. Risk: "money".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-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).

Scopes (ALL): \["payments:config"]. Risk: "money".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-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.

Scopes (ALL): \["payments:config"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-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.

Scopes (ALL): \["payments"]. Risk: "read".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-list-payment-rows)

## onboarding\_check\_payment\_provider

Verify the current payment configuration and return specific remaining requirements. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding\_complete.

Scopes (ALL): \["payments:config"]. Risk: "write".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-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. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding\_complete.

Scopes (ALL): \["payments:config"]. Risk: "money".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-confirm-payment-webhook)

## onboarding\_connect\_payment\_provider

Save the selected payment provider configuration and verify readiness without charging the owner. The first accepted payment of at least 10 RUB secures the trial advance. Optional: payment setup is not part of the mandatory onboarding path and never blocks onboarding\_complete.

Scopes (ALL): \["payments:config"]. Risk: "money".

[Вход, результат и права](https://telegafirst.com/docs/mcp-tool-onboarding-connect-payment-provider)