Перейти к содержимому
REST API · JSON

Интеграция - это один POST-запрос

Зарегистрируйте платеж, получите paymentUrl и перенаправьте покупателя. Дальше АТОЛ Pay: платежная форма, 3-D Secure, банки, СБП и чек по 54-ФЗ.

  • Sandbox в один клик из личного кабинета - тестовые СБП и эквайринг уже подключены
  • Swagger UI на живом API
  • MCP-сервер: документация прямо в ИИ-ассистенте
POST /v1/ecom/payments
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. 1

    Регистрация платежа

    POST /v1/ecom/payments - сумма, orderId, способы оплаты, при необходимости блок receipt для чека.

  2. 2

    Редирект покупателя

    В ответе приходит paymentUrl - платежная страница АТОЛ Pay с 3-D Secure и антифродом.

  3. 3

    Уведомление со статусом

    HTTP POST на ваш notificationUrl: статусы платежа, возврата, фискализации и подписок.

  4. 4

    Чек - автоматически

    С блоком receipt чек «Приход» уходит в АТОЛ Онлайн после успешной оплаты.

Webhooks

Уведомления о статусах

При каждой смене статуса - платеж, возврат, чек, подписка - АТОЛ Pay отправляет POST на ваш notificationUrl. Плюс метод опроса статуса как fallback.

Справочник уведомлений
Callback type=payment
// 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/
Productionlk.atolpay.runew-api-mobile.atolpay.ru/v1/ecom/

Интеграция через ИИ

Документация - прямо в вашем ИИ-ассистенте

MCP-сервер АТОЛ Pay отдает документацию, коды ошибок, рецепты интеграции и конструктор запросов Claude, Cursor и другим ИИ-агентам. Подключается по ссылке - устанавливать ничего не нужно, а ассистент сверяется с актуальной спецификацией.

Подключить MCP-сервер
Claude Code
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

Вопросы разработчиков

Подключение АТОЛ Pay

Начните с sandbox

Тестовая среда подключается самостоятельно из личного кабинета - без заявок и ожидания. Остались вопросы по интеграции? Напишите нам, поможем спланировать.