Перейти к содержимому
Оплата на стороне АТОЛ Pay

Готовая платежная страница для сайта и приложения

Платежная страница АТОЛ Pay - страница оплаты, которая открывается по ссылке paymentUrl из ответа API. Покупатель платит картой, через СБП или T-Pay, при необходимости подтверждает оплату кодом 3-D Secure и возвращается на ваш сайт, а статус заказа приходит уведомлением.

  • Карта, СБП и T-Pay
  • 3-D Secure и антифрод
  • Возврат на сайт по returnUrl

Простыми словами

Что такое платежная страница

Это готовая страница оплаты, которая открывается по ссылке из ответа API. Покупатель вводит данные карты или выбирает СБП и T-Pay на стороне АТОЛ Pay, там же проходит 3-D Secure, а ваш сайт получает статус оплаты уведомлением.

Где покупатель вводит данные карты
Своя платежная форма на сайтеВ форме на вашем сайте
Платежная страница АТОЛ PayНа странице АТОЛ Pay, которая открывается по ссылке paymentUrl
Кто проводит 3-D Secure
Своя платежная форма на сайтеПереход к банку за кодом встраиваете в форму сами
Платежная страница АТОЛ PayАТОЛ Pay: проверяет карту и при необходимости отправляет покупателя к банку за кодом
Проверка на мошенничество
Своя платежная форма на сайтеНастраиваете и поддерживаете сами
Платежная страница АТОЛ PayАТОЛ Pay анализирует детали заказа перед списанием
Кто обновляет способы оплаты
Своя платежная форма на сайтеВаши разработчики дорабатывают форму
Платежная страница АТОЛ PayВы подключаете способ в личном кабинете и включаете в настройках заказов - без правок в коде
Что остается вашему сайту
Своя платежная форма на сайтеВся форма оплаты и ее поддержка
Платежная страница АТОЛ PayЗарегистрировать платеж и обработать уведомление

Путь покупателя

От кнопки «Оплатить» до статуса заказа

Так проходит одностадийный платеж. Если 3-D Secure не пройден, статус 12 разрешает повторить оплату, а при статусе 3 заказ регистрируют заново.

  1. Шаг 1paymentUrl

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

    Ваш сервер отправляет запрос с суммой, номером заказа и returnUrl и получает в ответе ссылку на оплату.

  2. Шаг 2redirect

    Переход на страницу

    Сайт или приложение перенаправляет покупателя по ссылке. Он выбирает способ оплаты и нажимает «Оплатить».

  3. Шаг 33-D Secure

    Проверки

    АТОЛ Pay проверяет платеж на мошенничество и узнает, подключена ли карта к 3-D Secure. Если да - покупатель вводит код на странице своего банка.

  4. Шаг 4returnUrl

    Результат оплаты

    АТОЛ Pay списывает деньги и показывает итог с кнопкой «Вернуться в магазин» - она ведет на ваш returnUrl.

  5. Шаг 5type: payment

    Статус заказа

    На notificationUrl приходит уведомление с результатом. Если оно задержалось, статус можно запросить по номеру заказа.

Два сценария

Списать сразу или сначала заморозить деньги

Сценарий выбирается параметром sessionType при регистрации платежа. Если его не передать, действует настройка из личного кабинета.

Одностадийная оплата

Деньги списываются сразу

Списание и зачисление проходят одной операцией. Это самый распространенный сценарий для интернет-магазинов.

  • Результат приходит в уведомлении об оплате
  • В день оплаты платеж отменяется без комиссии
  • В другие дни - полный или частичный возврат
  • Отмена и возврат - через API или личный кабинет

sessionType: "oneStep"

Двухстадийная оплата

Сначала холдирование средств

Для бронирований, аренды с депозитом, маркетплейсов и услуг, где заказ сначала подтверждает продавец или исполнитель.

  • После оплаты сумма блокируется на счете покупателя
  • Уведомление первой стадии - статус 11, «Ожидает списания»
  • Списание запрашиваете сами не позднее 7 суток
  • Пока деньги заморожены, отмена проходит без комиссии

sessionType: "twoStep"

Чек вместе с оплатой

Передайте блок receipt при регистрации платежа - после успешной оплаты чек уйдет в АТОЛ Онлайн. Если email покупателя не указан, чек отправится на адрес, введенный на платежной форме.

Фискализация чеков

Где пригодится

Одна страница оплаты для сайта и приложения

Страница открывается по ссылке, поэтому подключается одинаково в корзине интернет-магазина, в мобильном приложении и в сервисе бронирования.

Интернет-магазины

Оплата корзины одной операцией: покупатель возвращается на сайт, а заказ меняет статус по уведомлению. Чек уходит вместе с оплатой.

Решение для интернет-магазинов

Мобильные приложения

Приложение открывает ту же ссылку на оплату. Если передать ID покупателя, карта сохранится для оплаты в один клик.

Оплата в приложении

Бронирование и площадки

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

Платежи для площадок

Разработчикам

Ссылка на оплату - в ответе API

Зарегистрируйте платеж - в ответе придет paymentUrl. Перенаправьте на него покупателя, а результат получите уведомлением или запросом статуса.

POST /v1/ecom/payments
Зарегистрировать платеж и получить paymentUrl
GET /v1/ecom/payments/{orderId}/status
Узнать статус, если уведомление задержалось
POST /v1/ecom/payments/{orderId}/deposit
Списать деньги по двухстадийной оплате
POST /v1/ecom/payments/{orderId}/cancel
Отменить платеж или вернуть деньги
GET /v1/ecom/payments/cards
Получить сохраненные карты покупателя
Сценарий оплаты в документации
POST /v1/ecom/payments
{
  "amount": 250000,
  "orderId": "order-1024",
  "sessionType": "oneStep",
  "additionalProps": {
    "returnUrl": "https://shop.example.com/return",
    "notificationUrl": "https://shop.example.com/callbacks/atolpay"
  },
  "paymentMethods": [
    { "paymentType": "card", "bankId": 100 },
    { "paymentType": "sbp", "bankId": 100 },
    { "paymentType": "bank_app", "bankId": 700 }
  ]
}

Подключение

Запуск за четыре шага

Верстка и проверки уже готовы: от вас - регистрация платежа, редирект и обработка уведомлений.

Открыть документацию
  1. 01

    Подключите интернет-эквайринг

    Зарегистрируйтесь в личном кабинете и пройдите онбординг банка-партнера.

  2. 02

    Выберите способы оплаты

    Если набор одинаков для всех заказов, задайте его в настройках заказов по умолчанию. Если зависит от заказа - передавайте paymentMethods.

  3. 03

    Проверьте оплату в sandbox

    В тестовом кабинете уже подключены СБП и интернет-эквайринг без реальных денег: проведите одностадийный и двухстадийный платеж.

  4. 04

    Настройте обработку уведомлений

    Отвечайте HTTP 200 сразу после сохранения события и делайте обработчик идемпотентным - событие может прийти повторно.

FAQ

Вопросы о платежной странице

Платежная страница - коротко

Платежная страница АТОЛ Pay заменяет собственную платежную форму для сайта: вы регистрируете платеж по API, а покупатель платит на готовой странице оплаты и возвращается к вам. Разрабатывать свой платежный шлюз не нужно.

  • Карта, СБП и T-Pay - по составу запроса
  • 3-D Secure и антифрод на стороне сервиса
  • Статус оплаты - в уведомлении и по запросу

Читайте также: Интернет-эквайринг, Платежные ссылки, Документация API

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

Подключите оплату на своем сайте

Оставьте заявку - поможем подключить эквайринг, выбрать способы оплаты и проверить первый платеж в тестовой среде.