Skip to main content
Version: 1.0

LIFE PAY API ECOM

тестовые карты​

2201382000000062
2201382000000039
2201382000000013 сценарий frictionless (без ввода кода на ACS)
2201382000000005
2201382000000047 (код на ACS 1qwezxc)

структура JWT-токена​

{ "invoice_id": null, "service_id": <номер сервиса> }

сценарий оплаты картой:​

  1. приложение запрашивает настройки сервиса и отображает форму оплаты с доступными платежными методами
  2. приложение запрашивает параметры инвойса и дополняет ими поля формы
  3. пользователь вводит данные карты
  4. приложение создает криптограмму, используя LIFEPAY.checkout-скрипт и выполняет POST-запрос на создание токена
  5. API ECOM принимает данный запрос и расшифровывает токен, затем проверяет версию 3DS:
  • если терминал без 3DS - отдает 201, статус токена будет waiting_pay - можно переходить к оплате
  • если терминал с 3DS:
    • если карта с 3ds версии 2.0, то возвращает данные для отрисовки скрытого iframe на странице оплаты. Статус токена waiting_iframe - приложение должно отрисовать данный iframe. В данном случае приложение должно опрашивать статус токена до тех пор, пока статус не станет waiting_pay
  1. приложение делает запрос на создание оплаты токена из предыдущего пункта. API ECOM вернет идентификатор оплаты и статус "progress".
  2. приложение опрашивает статус оплаты если 3DS не требуется:
  • будет статус charged. Переходим к п.8

если 3DS требуется (оплата в статусе waiting_3ds):

  • приложение перенаправляет плательщика на страницу ACS
  • пользователь проходит 3ds-аутентификацию на странице эмитента, эмитент возвращает плательщика на страницу приложение с результатом прохождения 3D
  • приложение завершает платеж (PATCH).
  • возвращаемся в п.7
  1. Терминальные статусы оплаты:
  • charged - приложение отображает страницу оплаты. Инвойс переходит в статус success.
  • error - приложение отображает страницу с ошибкой, транслируя значение поля message. По кнопке "повторить" приложение возвращается в начало. Инвойс остается в статусе open.

сценарий оплаты через токенизацию ApplePay/YandexPay/GooglePay:​

шаги как в сценарии с картой, за исключением пунктов:

  1. пользователю открывается iframe поставщика токенизации, он выбирает свою карту, токен передается в приложение
  2. приложение передает полученный токен API ECOM (запрос на создание токена)

Статусы для СБП​

Для транзакций СБП появляется дополнительный статус pending, который полностью равен open, но служит признаком для фронта что был выполнен переход по кнопке "Оплатить по ссылке" и необходимо отображать лоадер на странице.

как отобразить QR-код СБП:​

  1. приложение запрашивает создание qr-кода
  2. приложение получает ответ в формате .svg и отображает его плательщику

Authentication​

jwt-токен

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer