Интернет-эквайринг для сайта и приложения
Интернет-эквайринг АТОЛ Pay - прием оплаты картой, через СБП и T-Pay на готовой платежной странице. Вы регистрируете платеж одним запросом к API, а чек по 54-ФЗ уходит в АТОЛ Онлайн автоматически. Комиссия - 0,5–2,9 %, подключение бесплатное.
- Карта, СБП и T-Pay
- Подключение - 0 ₽
- Чек по 54-ФЗ с оплатой
Простыми словами
Как работает интернет-эквайринг
Вы регистрируете платеж одним запросом к API и отправляете покупателя на платежную страницу АТОЛ Pay. Покупатель платит картой, через СБП или T-Pay, а ваш сервер получает статус оплаты уведомлением. Деньги списываются сразу или сначала замораживаются - это зависит от типа оплаты.
- Как списываются деньги
- Одностадийная оплатаОдной операцией: списание и зачисление сразу
- Двухстадийная оплатаВ два этапа: сначала заморозка на счете покупателя, затем списание
- Когда подтвердить списание
- Одностадийная оплатаНе нужно - деньги списываются при оплате
- Двухстадийная оплатаНе позднее 7 суток: запросом deposit или кнопкой в личном кабинете
- Отмена без комиссии
- Одностадийная оплатаВ день оплаты
- Двухстадийная оплатаПока деньги заморожены
- Кому подходит
- Одностадийная оплатаИнтернет-магазинам - самый распространенный сценарий
- Двухстадийная оплатаБронированию, аренде с депозитом и заказам, где нужно подтвердить наличие
- Параметр в запросе
- Одностадийная оплатаsessionType: "oneStep"
- Двухстадийная оплатаsessionType: "twoStep"
| Параметр | Одностадийная оплата | Двухстадийная оплата |
|---|---|---|
| Как списываются деньги | Одной операцией: списание и зачисление сразу | В два этапа: сначала заморозка на счете покупателя, затем списание |
| Когда подтвердить списание | Не нужно - деньги списываются при оплате | Не позднее 7 суток: запросом deposit или кнопкой в личном кабинете |
| Отмена без комиссии | В день оплаты | Пока деньги заморожены |
| Кому подходит | Интернет-магазинам - самый распространенный сценарий | Бронированию, аренде с депозитом и заказам, где нужно подтвердить наличие |
| Параметр в запросе | sessionType: "oneStep" | sessionType: "twoStep" |
Путь платежа
Как проходит оплата - от корзины до чека
Так выглядит одностадийный платеж. Ваш сервер участвует в начале и в конце, все между ними берет на себя АТОЛ Pay.
- Шаг 1oneStep
Регистрация платежа
Ваш сервер отправляет в API сумму, номер заказа и адрес возврата и получает ссылку на оплату.
- Шаг 2paymentUrl
Платежная страница
Покупатель переходит по ссылке и выбирает карту, СБП или T-Pay. Свою платежную форму делать не нужно.
- Шаг 3confirm3dsretryError
Проверка и 3-D Secure
АТОЛ Pay проверяет платеж на мошенничество и при необходимости запрашивает код банка. Если код не принят, но повтор возможен, покупатель пробует снова.
- Шаг 4success
Списание
Деньги списываются со счета покупателя. Он видит результат и кнопку «Вернуться в магазин», которая ведет на ваш returnUrl.
- Шаг 5paymentfiscal
Уведомление и чек
Сервер получает уведомление со статусом оплаты. Если в платеже был блок receipt, чек уходит в АТОЛ Онлайн и приходит уведомление о фискализации.
Отмена и возврат
Возврат по эквайрингу или отмена - решает дата
Обе операции запускают одним запросом к API или в личном кабинете. Какая из них пройдет, АТОЛ Pay определяет сам - по дню оплаты и стадии платежа.
Отмена
Без комиссии
Одностадийный платеж отменяют в день оплаты, двухстадийный - пока деньги заморожены и не списаны.
- Отменить можно всю сумму или часть
- Комиссия за платеж не списывается
- Частичная отмена - только в Т-Банке, в Альфа-Банке пройдет частичный возврат
- Результат приходит в уведомлении type=cancel
POST /v1/ecom/payments/{orderId}/cancel
Возврат
Всей суммы или части
Одностадийный платеж возвращают со следующего дня после оплаты, двухстадийный - после списания.
- Частичный возврат по сумме или по позициям чека
- Чек «Возврат прихода» формируется сам, если платеж был с чеком
- Результат приходит в уведомлении type=refund
GET /v1/ecom/payments/{orderId}/refund-items
Чеки по оплатам и возвратам
Передайте блок receipt в запросе платежа: после оплаты чек «Приход» уйдет в облачную кассу АТОЛ Онлайн, а при отмене или возврате - чек «Возврат прихода». Для предоплаты с зачетом аванса и маркировки АТОЛ Онлайн v5 подключают напрямую.
Где пригодится
Эквайринг для сайта, приложения и площадки
Одна интеграция - платежная страница, уведомления и чеки - подходит разным моделям продаж.
Интернет-магазины
Оплата при оформлении заказа, возврат одним запросом и сохраненные карты для повторных покупок в один клик.
Эквайринг для интернет-магазинаМобильные приложения
Приложение открывает платежную страницу во встроенном браузере, а returnUrl возвращает покупателя обратно. Бэкенд тот же, что у сайта.
Оплата в приложенииПлощадки и платформы
Двухстадийная оплата до подтверждения продавца и частичные возвраты по позициям. Чеки с реквизитами агента и поставщика - через АТОЛ Онлайн v5.
Платежи для платформРазработчикам
Платеж - один запрос
Сервер регистрирует платеж и получает paymentUrl. Для двухстадийной оплаты передайте sessionType twoStep, для чека - блок receipt: чек уйдет в АТОЛ Онлайн после оплаты.
- POST /v1/ecom/payments
- Зарегистрировать платеж и получить ссылку на оплату
- 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://example.com/orders/1024",
"notificationUrl": "https://example.com/callbacks/atolpay"
},
"receipt": {
"buyer": { "email": "client@example.com" },
"positions": [{
"name": "Электронный билет", "price": 250000, "quantity": 1000,
"measure": 0, "paymentMethod": 3, "paymentSubject": 4, "tax": 0
}],
"providerId": 100,
"type": "sell",
"sno": 1
},
"paymentMethods": [
{ "paymentType": "card", "bankId": 100 },
{ "paymentType": "sbp", "bankId": 100 }
]
}Подключение
Как подключить интернет-эквайринг
Подключение бесплатное, запуск - от 15 минут. Подключить оплату на сайт можно через API, а принимать оплату без сайта - по платежным ссылкам.
- 01
Зарегистрируйтесь в кабинете
Аккаунт в lk.atolpay.ru создается по телефону и email за несколько минут.
- 02
Заполните анкету банка
Выберите Альфа-Банк, Т-Банк или Газпромбанк и пройдите онбординг в разделе «Интернет-эквайринг».
- 03
Проверьте оплату в sandbox
В тестовом кабинете уже подключены интернет-эквайринг и СБП без реальных денег: проверьте оплату, возврат и уведомления.
- 04
Запустите прием платежей
Создайте API-токен в разделе «Настройки > API Токены» и регистрируйте платежи в рабочей среде.
FAQ
Банковской картой, через СБП - из приложения любого банка-участника - и через приложение T-Pay. Все подключенные способы собраны на одной платежной странице, а набор задают в настройках личного кабинета или в запросе платежа.
Комиссия - 0,5–2,9 %: ставка зависит от вида деятельности (MCC-кода) и оборота и удерживается только с успешных платежей. Подключение и обслуживание бесплатны, абонентской платы нет. Точную ставку вы увидите при заполнении заявки на подключение.
Онлайн-оплаты в АТОЛ Pay проводят Альфа-Банк, Т-Банк и Газпромбанк. Банк выбирают при подключении и заполняют его анкету в личном кабинете.
Да. Интернет-эквайринг АТОЛ Pay подключают ИП и юрлица, зарегистрированные в РФ: нужен расчетный счет и анкета банка-партнера в личном кабинете. Отдельных тарифов для ИП нет - комиссия 0,5–2,9 % зависит от вида деятельности и оборота, подключение бесплатное, запуск занимает от 15 минут.
Отправьте запрос POST /v1/ecom/payments/{orderId}/cancel или оформите операцию в личном кабинете - вернуть можно всю сумму или часть. Одностадийный платеж в день оплаты отменяется, в другие дни по нему проходит возврат. Если платеж был с чеком, чек «Возврат прихода» сформируется автоматически.
Не больше 7 суток после оплаты: за это время вызовите метод deposit или нажмите «Провести списание» в личном кабинете. Автоматически деньги не списываются - если не запросить списание, заморозка истечет.
Если передавать блок receipt при регистрации платежа, чек автоматически фискализируется через провайдера АТОЛ Онлайн - отдельная интеграция с кассой не нужна. Для сложных сценариев (предоплата и зачет аванса, маркировка, агентские схемы) используется прямая интеграция с API АТОЛ Онлайн v5.
Платеж все равно проводится: ошибка фискализации не отменяет транзакцию. Результат отправки чека приходит отдельным уведомлением type=fiscal - по нему видно, ушел ли чек в АТОЛ Онлайн.
Подключение занимает от 15 минут - все оформляется онлайн. Регистрация в личном кабинете занимает несколько минут, дальше - анкета выбранного банка. Документов минимум: для ООО достаточно паспорта руководителя.
Интернет-эквайринг АТОЛ Pay - коротко
Интернет-эквайринг АТОЛ Pay, или онлайн-эквайринг, нужен, чтобы принимать онлайн-платежи на сайте, в приложении и по ссылке без собственной платежной формы. Подключить интернет-эквайринг могут ИП и компании: платежную страницу, 3-D Secure и чеки по 54-ФЗ берет на себя сервис, а подключить оплату на сайт можно через API или платежные ссылки.
- Комиссия 0,5–2,9 % - по виду деятельности и обороту
- Банки-партнеры: Альфа-Банк, Т-Банк, Газпромбанк
- Оплата картой, через СБП и T-Pay на одной странице
- Подключение 0 ₽, запуск от 15 минут
Читайте также: Что такое интернет-эквайринг, Как подключить эквайринг для ИП: тарифы и банки, Тарифы и комиссия эквайринга
Подключение АТОЛ Pay
Оставьте заявку - поможем выбрать банк-партнер, настроить платежную страницу и проверить оплату в тестовой среде.