mcp-izipay — MCP-сервер для Claude Code: платежи Izipay
Даёт агенту инструменты Izipay: авторизация и захват платежа, возвраты, куоты, токенизация карт, Yape и Plin. Для перуанских мерчантов с эквайринг-договором.
claude mcp add --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> --transport stdio izipay -- npx -y @codespar/mcp-izipayЧто делает mcp-izipay
Сервер закрывает двадцать инструментов платёжного эквайера Izipay. Это create_charge с отдельным capture_charge или отменой, возврат по уже проведённому платежу, карточные токены для повторных списаний, рассрочка в куотах, выгрузка транзакций и дневной расчётный батч get_settlement. Отдельно есть ссылки на оплату, прямая оплата через Yape и Plin, прохождение 3-D Secure, подписки.
Аутентификация — JWT Bearer. На первом вызове сервер отправляет { username, password, merchantCode } на /auth/login, держит токен в памяти и обновляет его за 60 секунд до истечения, так что вызывающему коду об этом думать не нужно. Мерчантские учётные данные передаются переменными окружения IZIPAY_USERNAME, IZIPAY_PASSWORD и IZIPAY_MERCHANT_CODE; IZIPAY_ENV переключает между production и sandbox, IZIPAY_BASE_URL переопределяет адрес.
Версия 0.1.0-alpha.1, и это существенно. Портал для разработчиков Izipay открыт только по договору, поэтому пути эндпоинтов выведены из публичных SDK и общих соглашений Niubiz — в README прямо сказано, что их нужно сверить со своим интеграционным комплектом до запуска в бой. На живых деньгах такой сервер без проверки путей использовать нельзя.
Какие задачи решает
- провести платёж картой и захватить его отдельным шагом
- оформить рассрочку в куотах под конкретный BIN и сумму
- вернуть деньги по ранее захваченному платежу
- сохранить карту токеном для повторных списаний без хранения PAN
- сверить транзакции с дневным расчётным батчем за дату
Примеры запросов агенту
- Создай платёж на 250 PEN с карты и оставь его без захвата — захвачу вручную
- Покажи, какие куоты доступны для этого BIN на сумму 1200 PEN
- Выгрузи расчётный батч за вчера и сверь его с моими заказами
Как установить mcp-izipay
Командой платформы
claude mcp add --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> --transport stdio izipay -- npx -y @codespar/mcp-izipayВместо <…> подставьте свои значения
Командой платформы
codex mcp add izipay --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> -- npx -y @codespar/mcp-izipayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"izipay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-izipay"
],
"env": {
"IZIPAY_USERNAME": "<IZIPAY_USERNAME>",
"IZIPAY_PASSWORD": "<IZIPAY_PASSWORD>",
"IZIPAY_MERCHANT_CODE": "<IZIPAY_MERCHANT_CODE>",
"IZIPAY_ENV": "<IZIPAY_ENV>",
"IZIPAY_BASE_URL": "<IZIPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"izipay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-izipay"
],
"env": {
"IZIPAY_USERNAME": "<IZIPAY_USERNAME>",
"IZIPAY_PASSWORD": "<IZIPAY_PASSWORD>",
"IZIPAY_MERCHANT_CODE": "<IZIPAY_MERCHANT_CODE>",
"IZIPAY_ENV": "<IZIPAY_ENV>",
"IZIPAY_BASE_URL": "<IZIPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e IZIPAY_USERNAME=<IZIPAY_USERNAME> -e IZIPAY_PASSWORD=<IZIPAY_PASSWORD> -e IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> -e IZIPAY_ENV=<IZIPAY_ENV> -e IZIPAY_BASE_URL=<IZIPAY_BASE_URL> izipay npx -y @codespar/mcp-izipayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-izipay
Как установить mcp-izipay в Claude Code?
Одной командой с учётными данными: `claude mcp add mcp-izipay -e IZIPAY_USERNAME=<IZIPAY_USERNAME> -e IZIPAY_PASSWORD=<IZIPAY_PASSWORD> -e IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> -- npx -y @codespar/mcp-izipay. Вариант с явным окружением и адресом: claude mcp add --env IZIPAY_USERNAME=<IZIPAY_USERNAME> --env IZIPAY_PASSWORD=<IZIPAY_PASSWORD> --env IZIPAY_MERCHANT_CODE=<IZIPAY_MERCHANT_CODE> --env IZIPAY_ENV=<IZIPAY_ENV> --env IZIPAY_BASE_URL=<IZIPAY_BASE_URL> --transport stdio izipay -- npx -y @codespar/mcp-izipay`.
Что делает mcp-izipay?
Подключает агента к API перуанского эквайера Izipay: платежи, захват, отмена, возвраты, токены карт, куоты, расчёты, ссылки на оплату, Yape, Plin, 3-D Secure и подписки.
Можно ли запускать в продакшене?
Статус — alpha, а пути эндпоинтов выведены косвенно, потому что полная REST-документация Izipay доступна только мерчантам с договором. Сверьте каждый вызов со своим интеграционным комплектом до боевых платежей.
