Перейти к содержимому

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

Сценарий оплаты на платежной странице АТОЛ 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-диаграмма

Загрузка диаграммы…

Пример запроса

json
{
  "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 }
  ]
}
json
{
  "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)

Отмена и возврат

Отмена без комиссии возможна только в день оплаты; в другие дни выполняется возврат. Подробнее - в разделе Отмена/возврат.