Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

YooKassa (BYOK) — connector documentation

  • MCP endpoint: https://byok-yookassa.connectorbay.com/mcp
  • REST API: POST https://byok-yookassa.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-yookassa.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own YooKassa shop ID (the first part of the Basic credential), sent in the X-Upstream-Key header and the secret key of the shop (second part of the Basic credential) in X-Upstream-Key-2 of every request (never stored, logged or cached)
  • Health: https://byok-yookassa.connectorbay.com/health · Tool schemas: https://byok-yookassa.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-yookassa · agent@connectorbay.com

What YooKassa (BYOK) is for

YooKassa (BYOK) lets an AI assistant read your own YooKassa data through the YooKassa API with a key you supply (shop ID (the first part of the Basic credential)). Read-only: 9 tools (get_shop_settings, list_payments, get_payment, list_refunds, get_refund, list_receipts, list_payouts, list_deals, list_sbp_banks). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.yookassa.ru. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by YooKassa. YooKassa and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which YooKassa shop is this key for and is it a test shop?"
  • "Which YooKassa payments succeeded since 2026-01-01?"
  • "What is the state of YooKassa payment 2ff7d6c0-000f-5000-9000-1f4d1a2b3c4d?"
  • "Which refunds were made for YooKassa payment 2ff7d6c0-000f-5000-9000-1f4d1a2b3c4d?"
  • "What is the status of YooKassa refund 216749f7-0016-50be-b000-078d43a63ae4?"
  • "Which receipts were registered for YooKassa payment 2ff7d6c0-000f-5000-9000-1f4d1a2b3c4d?"

What it does

  • get_shop_settings: Show the shop or gateway the key belongs to: account id, name, test flag, enabled payment methods, fiscalization setting and payout balance.
  • list_payments: List payments newest first with status, amount, income after fees, payment method type and dates. Filter by status, method and creation or capture time; page with cursor.
  • get_payment: Get one payment by its id: status, amount, fees, payment method type, description, cancellation reason and timestamps.
  • list_refunds: List refunds newest first with the refunded payment id, status, amount and date; filter by payment, status and creation time.
  • get_refund: Get one refund by id with its payment id, status, amount, description and cancellation details.
  • list_receipts: List fiscal receipts (payment or refund receipts) with fiscal document number, registration time and status; filter by payment, refund, status and time.
  • list_payouts: List payouts made to cards, YooMoney wallets or via the Faster Payments System, with status, amount and dates; filter by status, destination type and creation time.
  • list_deals: List safe deals (marketplace payment holds) with status, balance and expiry; filter by status, text search and creation time.
  • list_sbp_banks: List banks that take part in the Faster Payments System (SBP) and can receive payouts, with bank id, name and BIC.

BYOK key

You bring your own YooKassa shop ID (the first part of the Basic credential) (https://yookassa.ru/my/merchant/integration/api-keys). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.yookassa.ru over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the YooKassa API (api.yookassa.ru) with a BYOK key; documentation: https://yookassa.ru/developers/api. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by YooKassa. YooKassa and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your YooKassa account.

Built for: Worldwide. Languages: English.