Интеграция - это один POST-запрос
Зарегистрируйте платеж, получите paymentUrl и перенаправьте покупателя. Дальше АТОЛ Pay: платежная форма, 3-D Secure, банки, СБП и чек по 54-ФЗ.
- Sandbox в один клик из личного кабинета - тестовые СБП и эквайринг уже подключены
- Swagger UI на живом API
- MCP-сервер: документация прямо в ИИ-ассистенте
curl -X POST "https://new-api-mobile.atolpay.ru/v1/ecom/payments" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"amount": 250000,
"orderId": "order-1024",
"sessionType": "oneStep",
"additionalProps": {
"returnUrl": "https://shop.ru/return",
"notificationUrl": "https://shop.ru/callbacks/atolpay"
},
"paymentMethods": [
{ "paymentType": "card", "bankId": 100 },
{ "paymentType": "sbp", "bankId": 100 }
]
}'Integration flow
Как устроен платежный флоу
- 1
Регистрация платежа
POST /v1/ecom/payments - сумма, orderId, способы оплаты, при необходимости блок receipt для чека.
- 2
Редирект покупателя
В ответе приходит paymentUrl - платежная страница АТОЛ Pay с 3-D Secure и антифродом.
- 3
Уведомление со статусом
HTTP POST на ваш notificationUrl: статусы платежа, возврата, фискализации и подписок.
- 4
Чек - автоматически
С блоком receipt чек «Приход» уходит в АТОЛ Онлайн после успешной оплаты.
Webhooks
Уведомления о статусах
При каждой смене статуса - платеж, возврат, чек, подписка - АТОЛ Pay отправляет POST на ваш notificationUrl. Плюс метод опроса статуса как fallback.
// POST на ваш notificationUrl при смене статуса
{
"type": "payment",
"orderId": "order-1024",
"paymentStatus": 1,
"amount": 250000
}
// Ответьте 200 OK - обработчик должен быть идемпотентнымВозможности
Что умеет API
Одно- и двухстадийные платежи
oneStep / twoStep: холдирование средств и списание отдельным запросом, отмена без комиссии на этапе заморозки.
Подписки
Планы с периодом и trial, автоматические рекуррентные списания, уведомление по каждому продлению.
Сохраненные карты
Привязка карт к buyerId и оплата в один клик.
Возвраты
Полные и частичные - через API или личный кабинет. Чек возврата формируется автоматически.
Фискализация
Блок receipt в платеже или прямая интеграция с АТОЛ Онлайн v5 для сложных сценариев 54-ФЗ.
Статусы и уведомления
Уведомления по платежам, возвратам, чекам и подпискам + опрос статуса как запасной вариант.
Среды
Sandbox и production
Песочница подключается самостоятельно: зарегистрируйтесь в личном кабинете lk.atolpay.ru и выберите в меню «Перейти в sandbox». В тестовом кабинете уже подключены тестовые СБП и интернет-эквайринг - платежи проходят без реальных денег. API-токен генерируется в разделе «Настройки > API Токены».
| Среда | Личный кабинет | API |
|---|---|---|
| Sandbox | Меню «Перейти в sandbox» в боевом кабинете | croc-sandbox-api-mobile.atolpay.ru/v1/ecom/ |
| Production | lk.atolpay.ru | new-api-mobile.atolpay.ru/v1/ecom/ |
Интеграция через ИИ
Документация - прямо в вашем ИИ-ассистенте
MCP-сервер АТОЛ Pay отдает документацию, коды ошибок, рецепты интеграции и конструктор запросов Claude, Cursor и другим ИИ-агентам. Подключается по ссылке - устанавливать ничего не нужно, а ассистент сверяется с актуальной спецификацией.
claude mcp add --transport http atol-docs https://pay.atol.ru/mcp
# подключение по HTTPS, ставить ничего не нужно
# инструменты: search_docs, get_method, get_error_codes,
# start_integration, build_payment_request, validate_receipt …FAQ
Вопросы разработчиков
Да, sandbox подключается самостоятельно: зарегистрируйтесь в личном кабинете lk.atolpay.ru и выберите в меню «Перейти в sandbox». В тестовом кабинете уже подключены тестовые СБП и интернет-эквайринг без реальных денег; API-токен генерируется в разделе «Настройки > API Токены». API песочницы: croc-sandbox-api-mobile.atolpay.ru/v1/ecom/.
Секретный API-токен генерируется в личном кабинете (Настройки > API Токены) и передается в HTTP-заголовке Authorization в каждом запросе.
Да. Живой Swagger UI доступен на new-api-mobile.atolpay.ru/v1/ecom/documentation/, та же спецификация в формате OpenAPI 3.0 опубликована в портале документации и используется MCP-сервером.
Это сервер протокола Model Context Protocol, который отдает документацию API, коды ошибок, рецепты интеграции и конструктор запросов ИИ-ассистентам (Claude, Cursor, VS Code). Работает на нашей стороне и подключается по ссылке через интернет - устанавливать и запускать ничего не нужно. Подключите его - и ассистент напишет интеграцию, сверяясь с актуальной спецификацией.
Подключение АТОЛ Pay
Тестовая среда подключается самостоятельно из личного кабинета - без заявок и ожидания. Остались вопросы по интеграции? Напишите нам, поможем спланировать.