mcp-payway — MCP-сервер для Claude Code: приём карт в Аргентине
Подключает агента к платёжному шлюзу Payway: токенизация карты, списание, подтверждение и возврат. Пригодится тем, кто пишет оплату для аргентинского мерчанта.
claude mcp add --env PAYWAY_PUBLIC_API_KEY=<PAYWAY_PUBLIC_API_KEY> --env PAYWAY_PRIVATE_API_KEY=<PAYWAY_PRIVATE_API_KEY> --env PAYWAY_ENV=<PAYWAY_ENV> --transport stdio payway -- npx -y @codespar/mcp-paywayЧто делает mcp-payway
Сервер даёт агенту шесть инструментов поверх Payway API. create_token превращает данные карты в одноразовый токен, create_payment проводит списание по токену — одной операцией или с распределением между получателями, confirm_payment ловит ранее авторизованный платёж во двухшаговой схеме. Ещё есть get_payment и list_payments для выборки, refund_payment умеет возвращать всю сумму или её часть.
Ключи разные по правам. Публичный открывает только POST /tokens, приватный нужен для платежей, возвратов и запросов. Оба передаются в заголовке apikey, а не в Authorization: Bearer — это стоит запомнить перед первой отладкой. Оба обязательны, PAYWAY_ENV переключает sandbox и production, без него работа идёт в песочнице Decidir.
Суммы сервер принимает целыми числами в минорных единицах: 50000 — это ARS 500.00. Данные карты агент не придумывает — PAN, срок и CVV должен собрать у пользователя или достать из хранилища. payment_method_id задаёт бренд карты: 1 для Visa, 31 для Mastercard, 15 для Maestro.
Какие задачи решает
- превратить данные карты в одноразовый токен
- провести списание с рассрочкой в Payway
- подтвердить авторизованный платёж из двухшаговой схемы
- сделать частичный возврат по платежу
- выбрать платежи по
siteOperationIdили магазину
Примеры запросов агенту
- Создай токен карты через Payway, потом спиши по нему 50000 в песочнице
- Покажи список платежей по
merchantIdза нужный период - Верни половину суммы по последнему платежу через
refund_payment
Как установить mcp-payway
Командой платформы
claude mcp add --env PAYWAY_PUBLIC_API_KEY=<PAYWAY_PUBLIC_API_KEY> --env PAYWAY_PRIVATE_API_KEY=<PAYWAY_PRIVATE_API_KEY> --env PAYWAY_ENV=<PAYWAY_ENV> --transport stdio payway -- npx -y @codespar/mcp-paywayВместо <…> подставьте свои значения
Командой платформы
codex mcp add payway --env PAYWAY_PUBLIC_API_KEY=<PAYWAY_PUBLIC_API_KEY> --env PAYWAY_PRIVATE_API_KEY=<PAYWAY_PRIVATE_API_KEY> --env PAYWAY_ENV=<PAYWAY_ENV> -- npx -y @codespar/mcp-paywayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"payway": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-payway"
],
"env": {
"PAYWAY_PUBLIC_API_KEY": "<PAYWAY_PUBLIC_API_KEY>",
"PAYWAY_PRIVATE_API_KEY": "<PAYWAY_PRIVATE_API_KEY>",
"PAYWAY_ENV": "<PAYWAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"payway": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-payway"
],
"env": {
"PAYWAY_PUBLIC_API_KEY": "<PAYWAY_PUBLIC_API_KEY>",
"PAYWAY_PRIVATE_API_KEY": "<PAYWAY_PRIVATE_API_KEY>",
"PAYWAY_ENV": "<PAYWAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PAYWAY_PUBLIC_API_KEY=<PAYWAY_PUBLIC_API_KEY> -e PAYWAY_PRIVATE_API_KEY=<PAYWAY_PRIVATE_API_KEY> -e PAYWAY_ENV=<PAYWAY_ENV> payway npx -y @codespar/mcp-paywayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-payway
Как установить mcp-payway в Claude Code?
Выполните `claude mcp add mcp-payway -e PAYWAY_PUBLIC_API_KEY=<PAYWAY_PUBLIC_API_KEY> -e PAYWAY_PRIVATE_API_KEY=<PAYWAY_PRIVATE_API_KEY> -- npx -y @codespar/mcp-payway`. Ключи подставьте свои.
Что делает mcp-payway?
Соединяет ИИ-агента с платёжным шлюзом Payway: токенизация карты, списание, подтверждение, поиск платежей и возврат. Работает через шесть инструментов поверх API.
Какие ключи нужны для работы?
Два: PAYWAY_PUBLIC_API_KEY для токенизации и PAYWAY_PRIVATE_API_KEY для остальных операций. Оба уходят в заголовке apikey.
