ЮKassa
Connect YooKassa to the AI agent: payments, refunds, receipts and payment methods
Connect YooKassa to the AI agent: payments, refunds, receipts and payment methods. The agent totals revenue for a period and sends a daily summary.
DocumentationВернули 214 800 ₽ — это 3,1% от выручки магазина.
Всего 37 возвратов, две трети по оплатам картой, остальное — СБП. Против июня доля выросла на 0,8 п.п.: почти весь прирост дал один товар, по нему 11 возвратов подряд.
Integration scenarios
Revenue totals for a period
The agent totals payments for a period: how much went through, how much was canceled and how much was refunded, with no exports from the merchant account.
Breakdown of a single payment
The agent finds a payment by date, amount or status and shows the payment method, the fiscal receipt and the refunds linked to it.
Daily revenue summary
The agent posts a summary to your work chat on a schedule: revenue for the day, cancellations and refunds for the connected shop.
Refunds and what caused them
The agent collects refunds for a period, ties them back to the original payments and shows which payment methods generate the most.
How to connect
Sign in to YooKassa with the right role
API keys are available to the shop owner and to a user with the “Developer” role. Without it, ask the owner to add you to the account with that role — otherwise the keys section stays closed.
Copy shopId from “Settings — Shop”
Pick the right shop in the switcher at the top, then open “Settings — Shop”: the identifier is labelled shopId there. Every shop, including a test one, has its own value.
Issue the key in “Integration — API keys”
Open “Integration — API keys”, click “Issue key” in the secret key block and confirm the action with the SMS password sent to the phone linked to the account.
Copy the key from the one-time window
The secret key is shown only once — it is available in that window alone. Once closed you cannot view it again, only reissue it; after a reissue the previous key keeps working for 48 hours.
What the agent does in the first 10 minutes
- Totals up payments for any period: succeeded, canceled, refunded — with no manual export from the dashboard
- Finds a payment by date and status and shows its payment method, receipt and linked refunds
- Sends a daily revenue digest to Telegram — you approve the time, then it runs on its own
FAQ
How do I connect YooKassa?
With a pair of values: the shopId from Settings and Shop, and the secret key from Integration, API keys, Issue key, confirmed with an SMS password. You need the owner or Developer role, otherwise the section will not open, and the key is shown only once.
What does the agent see in YooKassa?
Payments and their statuses, refunds, fiscal receipts and payment methods for the shop whose shopId is connected.
How is this different from a bank?
YooKassa is about collecting payments from customers: the agent sees payments and refunds, not your current account statement. Money reaches the account as a payout, and that is visible in the banking connector.
What is not available with this key?
The payouts section and webhook subscriptions do not work with a shopId and secret key pair: payouts are a separate product with its own key, and notifications are configured in the YooKassa merchant account.
