Одностадийный платеж
Сценарий оплаты на платежной странице АТОЛ Pay одной операцией - от регистрации платежа до callback со статусом.
Одностадийный платеж - списание средств со счета покупателя и их зачисление на счет продавца одной операцией. Это самый распространенный сценарий для интернет-магазинов.
Пошаговый сценарий
Клиент выбирает онлайн-оплату на сайте или в приложении.
Продавец направляет в АТОЛ Pay запрос на регистрацию одностадийного
платежа - POST /v1/ecom/payments
с параметрами: сумма списания (amount, в копейках), номер заказа в системе
магазина (orderId), тип платежа sessionType: "oneStep", URL возврата
клиента (additionalProps.returnUrl), опционально ИНН и КПП.
Для получения уведомлений по всем событиям укажите
additionalProps.notificationUrl - тип события определяется по полю type
в теле входящего callback, а в query-параметры URL можно добавить свои данные
(например, для идентификации заказа или пользователя).
АТОЛ Pay возвращает data.orderId и data.paymentUrls.main - адрес
платежной формы. В случае ошибки сообщите пользователю о недоступности сервиса.
Продавец перенаправляет клиента на платежную форму по
data.paymentUrls.main.
Клиент на платежной странице заполняет форму реквизитами карты и нажимает «Оплатить». АТОЛ Pay анализирует детали заказа на предмет мошенничества, проверяет вовлеченность карты в 3-D Secure и при необходимости перенаправляет браузер клиента на страницу банка-эмитента для ввода проверочного кода.
Клиент вводит проверочный код 3-D Secure.
- Авторизация неуспешна, повтор невозможен (
paymentStatus: 3) - зарегистрируйте заказ заново, начиная с первого шага. - Авторизация неуспешна, повтор возможен (
paymentStatus: 12) - повторите попытку оплаты. - Авторизация успешна - переход к следующему шагу.
АТОЛ Pay списывает денежные средства со счета клиента и показывает
страницу с результатом оплаты и кнопкой «Вернуться в магазин» (редирект на
returnUrl).
Продавец получает callback с результатом оплаты (type: "payment") или
запрашивает статус методом
GET /v1/ecom/payments/{orderId}/status,
если callback не пришел в течение длительного времени.
Sequence-диаграмма
Пример запроса
{
"amount": 10000,
"orderId": "b0d84710-71f0-49ee-8219-f1b31a8d6770",
"sessionType": "oneStep",
"additionalProps": {
"returnUrl": "https://shop.example.com/return",
"notificationUrl": "https://shop.example.com/callbacks/atolpay?orderId=12345"
},
"paymentMethods": [
{ "paymentType": "card", "bankId": 100 }
]
}{
"status": "success",
"data": {
"orderId": "b0d84710-71f0-49ee-8219-f1b31a8d6770",
"amount": 10000,
"paymentUrls": {
"main": "https://atolpay.ru/b0d84710-71f0-49ee-8219-f1b31a8d6770"
},
"positions": []
}
}Ответ сокращен: полный состав (paymentUrl, mainFrame, mainApp, direct)
- в описании метода регистрации.
Отмена и возврат
Отмена без комиссии возможна только в день оплаты; в другие дни выполняется возврат. Подробнее - в разделе Отмена/возврат.