Готовая платежная страница для сайта и приложения
Платежная страница АТОЛ 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Зарегистрировать платеж и обработать уведомление
| Параметр | Своя платежная форма на сайте | Платежная страница АТОЛ Pay |
|---|---|---|
| Где покупатель вводит данные карты | В форме на вашем сайте | На странице АТОЛ Pay, которая открывается по ссылке paymentUrl |
| Кто проводит 3-D Secure | Переход к банку за кодом встраиваете в форму сами | АТОЛ Pay: проверяет карту и при необходимости отправляет покупателя к банку за кодом |
| Проверка на мошенничество | Настраиваете и поддерживаете сами | АТОЛ Pay анализирует детали заказа перед списанием |
| Кто обновляет способы оплаты | Ваши разработчики дорабатывают форму | Вы подключаете способ в личном кабинете и включаете в настройках заказов - без правок в коде |
| Что остается вашему сайту | Вся форма оплаты и ее поддержка | Зарегистрировать платеж и обработать уведомление |
Путь покупателя
От кнопки «Оплатить» до статуса заказа
Так проходит одностадийный платеж. Если 3-D Secure не пройден, статус 12 разрешает повторить оплату, а при статусе 3 заказ регистрируют заново.
- Шаг 1paymentUrl
Регистрация платежа
Ваш сервер отправляет запрос с суммой, номером заказа и returnUrl и получает в ответе ссылку на оплату.
- Шаг 2redirect
Переход на страницу
Сайт или приложение перенаправляет покупателя по ссылке. Он выбирает способ оплаты и нажимает «Оплатить».
- Шаг 33-D Secure
Проверки
АТОЛ Pay проверяет платеж на мошенничество и узнает, подключена ли карта к 3-D Secure. Если да - покупатель вводит код на странице своего банка.
- Шаг 4returnUrl
Результат оплаты
АТОЛ Pay списывает деньги и показывает итог с кнопкой «Вернуться в магазин» - она ведет на ваш returnUrl.
- Шаг 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
- Получить сохраненные карты покупателя
{
"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 }
]
}Подключение
Запуск за четыре шага
Верстка и проверки уже готовы: от вас - регистрация платежа, редирект и обработка уведомлений.
- 01
Подключите интернет-эквайринг
Зарегистрируйтесь в личном кабинете и пройдите онбординг банка-партнера.
- 02
Выберите способы оплаты
Если набор одинаков для всех заказов, задайте его в настройках заказов по умолчанию. Если зависит от заказа - передавайте paymentMethods.
- 03
Проверьте оплату в sandbox
В тестовом кабинете уже подключены СБП и интернет-эквайринг без реальных денег: проведите одностадийный и двухстадийный платеж.
- 04
Настройте обработку уведомлений
Отвечайте HTTP 200 сразу после сохранения события и делайте обработчик идемпотентным - событие может прийти повторно.
FAQ
Платежная страница - готовая страница оплаты, на которую сайт или приложение перенаправляет покупателя по ссылке paymentUrl. Покупатель выбирает карту, СБП или T-Pay и платит, а 3-D Secure, антифрод и возврат на ваш сайт уже настроены на стороне АТОЛ Pay.
В своей платежной форме данные карты вводятся на вашем сайте, а 3-D Secure, проверку на мошенничество и новые способы оплаты приходится встраивать самим. На платежной странице АТОЛ Pay покупатель вводит данные карты на стороне сервиса, проверки проходят там же, а вашему сайту остается зарегистрировать платеж и обработать уведомление.
Банковская карта, СБП и T-Pay - из тех, что подключены в личном кабинете. Если набор одинаков для всех заказов, задайте его в разделе «Настройки > Настройки заказов»: тогда способы меняются без правок в коде. Если набор зависит от заказа, передайте массив paymentMethods при регистрации платежа.
3-D Secure - подтверждение оплаты картой кодом на странице банка, который выпустил карту. На платежной странице проверку проводит АТОЛ Pay: при необходимости он перенаправляет покупателя к банку за кодом. Если авторизация не прошла, статус 12 означает, что оплату можно повторить, а статус 3 - что заказ нужно зарегистрировать заново.
Да, это двухстадийная оплата: передайте sessionType: twoStep при регистрации платежа. После оплаты на платежной странице сумма блокируется на счете покупателя - это холдирование средств. Списание запросите не позднее чем через 7 суток методом deposit или кнопкой «Провести списание» в личном кабинете, иначе заморозка истечет. Пока средства заморожены, платеж можно отменить без комиссии.
Да. Передайте buyerId - идентификатор покупателя в вашей системе - при регистрации платежа. После успешной оплаты карта сохранится, и ее можно использовать для оплаты в один клик и рекуррентных списаний. Список карт запрашивают по buyerId, а привязку удаляют, когда покупатель отвязывает карту в вашем сервисе.
АТОЛ Pay показывает страницу с результатом оплаты и кнопкой «Вернуться в магазин» - она ведет на returnUrl из запроса регистрации платежа. Статус ваш сервер получает отдельно: уведомление type: payment приходит на notificationUrl, а если оно задержалось, статус можно запросить методом GET /v1/ecom/payments/{orderId}/status.
Платежная страница - коротко
Платежная страница АТОЛ Pay заменяет собственную платежную форму для сайта: вы регистрируете платеж по API, а покупатель платит на готовой странице оплаты и возвращается к вам. Разрабатывать свой платежный шлюз не нужно.
- Карта, СБП и T-Pay - по составу запроса
- 3-D Secure и антифрод на стороне сервиса
- Статус оплаты - в уведомлении и по запросу
Читайте также: Интернет-эквайринг, Платежные ссылки, Документация API
Смотрите также
Подключение АТОЛ Pay
Оставьте заявку - поможем подключить эквайринг, выбрать способы оплаты и проверить первый платеж в тестовой среде.