ЮKassa
на подключении неофициальныйПлатежи, двухстадийная оплата с холдированием, полные и частичные возвраты, чеки по 54-ФЗ.
Отдельного адреса у магазина нет: он вызывается через
общий эндпоинт аргументом server="yookassa".
Об источнике
Что это за источник
ЮKassa — платёжный сервис для приёма оплаты на сайте и в приложении: банковские карты, СБП, электронные кошельки и другие способы. Сервис предоставляет НКО «ЮМани».
Кому и зачем он нужен
e-suppy не принимает деньги и принимать не будет: иначе роутер стал бы участником расчётов со всеми договорными и фискальными обязательствами. Поэтому платёжный источник полезен не покупателю, а владельцу магазина, который поручает рутину агенту от своего имени:
- Проверить статус платежа по заказу, когда покупатель пишет, что оплатил, а заказ не подтверждён.
- Найти платежи за период и сверить их с заказами.
- Подготовить возврат по обращению клиента. Выполнить его агент сможет только после подтверждения человеком.
Что есть в API
REST-интерфейс с аутентификацией по идентификатору магазина и секретному ключу. Поддерживаются одностадийные и двухстадийные платежи — с холдированием суммы и последующим подтверждением, — полные и частичные возвраты, отправка чеков по 54-ФЗ и уведомления о смене статуса. Для разработки создаётся тестовый магазин.
Статус подключения
Не подключён. Платёжных инструментов в e-suppy пока нет: прежде чем они появятся, нужно решить, как подтверждение человека будет устроено технически, а не только описано в тексте.
Установка
# ЮKassa ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"e-suppy": {
"url": "https://mcp.e-suppy.com/mcp"
}
}
}# ЮKassa ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.
curl -X POST https://mcp.e-suppy.com/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_products",
"arguments":{"query":"сметана 15%"}}}'# ЮKassa ещё не подключён (на подключении).
# Ниже — как это будет выглядеть.
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("https://mcp.e-suppy.com/mcp") as (r, w, _):
async with ClientSession(r, w) as s:
await s.initialize()
await s.call_tool("search_products", {"query": "yookassa"})
Типовые операции в API категории
Так эти операции обычно называются у вендоров категории. Агенту они не видны: в e-suppy источник вызывается через общие инструменты роутера, и их набор при подключении не меняется.
Пример ответа
{
"id": "2f9c1a7e-payment",
"status": "waiting_for_capture",
"amount": { "value": "4190.00", "currency": "RUB" },
"receipt_registered": true,
"_meta": { "idempotency_key": "ord-88123" }
}