Обзор АТОЛ Pay Ecom
Интернет-эквайринг АТОЛ Pay - прием платежей на платежной странице, одностадийные и двухстадийные платежи, подписки, СБП и фискализация чеков.
Справочник к шагам 3–4
Контракт API: методы, поля, ограничения. По пути интеграции его читает ассистент; если собираете интеграцию сами - это ваш основной раздел. Начните с регистрации платежа и примеров.
АТОЛ Pay Ecom - сервис интернет-эквайринга. Продавец регистрирует платеж одним API-запросом, получает ссылку на платежную страницу и перенаправляет на нее покупателя. АТОЛ Pay берет на себя платежную форму, 3-D Secure, антифрод-проверки, работу с банками (Альфа-Банк, Т-Банк, ГПБ), СБП и фискализацию чеков через провайдера АТОЛ Онлайн.
Возможности
- Одностадийный платеж - списание средств со счета покупателя и зачисление на счет продавца одной операцией.
- Двухстадийный платеж - сначала заморозка (холдирование) средств, затем списание отдельным запросом. На этапе заморозки платеж можно отменить без комиссии.
- Подписки - планы подписок с периодом и пробным периодом, автоматическое рекуррентное списание, callback по каждому продлению.
- Методы оплаты - карта (
card: Альфа-Банк, Т-Банк, ГПБ), мобильное приложение банка (bank_app, Т-Pay), Система быстрых платежей (sbp: Альфа-Банк, Открытие, Райффайзен, Сбербанк, ЮКасса и другие банки НСПК), оплата долями (bnpl, Т-Банк Долями) и оплата по счету (account). - Сохраненные карты - привязка карт к
buyerIdи оплата в один клик. - Возвраты и отмены - полные и частичные, через API или личный кабинет.
- Фискализация - передайте блок
receiptпри регистрации платежа, и чек будет автоматически отправлен в АТОЛ Онлайн.
Глоссарий
| Термин | Значение |
|---|---|
| Платежная страница | Страница для оплаты по заданной сумме выбранным методом (карта, СБП, приложение банка и другие), открываемая по сгенерированной ссылке (paymentUrls.main). |
| Одностадийный платеж | Списание средств со счета покупателя и их зачисление на счет продавца одной операцией (sessionType: oneStep). |
| Двухстадийный платеж | Платеж в два этапа: сначала заморозка средств у покупателя, потом зачисление на счет продавца (sessionType: twoStep). На этапе заморозки можно отменить платеж без уплаты комиссии. |
| Callback (нотификация) | HTTP POST-запрос от АТОЛ Pay на ваш notificationUrl при смене статуса платежа, возврата, фискализации или подписки. |
| ЛК | Личный кабинет АТОЛ Pay - lk.atolpay.ru. |
| СБП | Система быстрых платежей. |
| ФФД | Формат фискальных документов. |
Основной флоу интеграции
Разделы
Пошаговые сценарии с sequence-диаграммами: одностадийный, двухстадийный платеж и подписки.
API: ПлатежиРегистрация платежа, статус, отмена/возврат, списание по двухстадийной оплате, сохраненные карты.
API: ЧекиБлок receipt, словари, агенты и поставщики.
API: ПодпискиПланы подписок, создание и отмена подписок.
Callback-уведомленияТипы callback, статусы платежа, примеры полезной нагрузки.
Коды ошибокПолный справочник ошибок API и callback.