Платежи по сохраненным данным карты
Платежи по сохраненным данным карты (рекуррентные платежи) лежат в основе такой схемы расчета за товары и услуги, когда клиент дает право торговцу автоматически списывать средства с его карты для оплаты заказов в будущем. Средства списываются с той карты, которая привязана к учетной записи клиента на сайте или в мобильном приложении торговца.
Система UnonaPay может обрабатывать два основных вида платежей по сохраненным данным:
-
регулярные - списания средств на установленную сумму заказа, совершаемые через определенный период времени, также называются подписками, например, автоматическая ежемесячная оплата членских взносов;
-
по запросу - списания средств, совершаемые по запросу торговца или клиента на сумму заказа и в момент фактической покупки или оказания услуги, например, оплата поездки в такси в мобильном приложении.
Регулярные платежи
Если ваш бизнес основан на периодической оплате, вы можете воспользоваться сервисом подписок UnonaPay. Создавайте планы для регулярных платежей с помощью API или настройте их в личном кабинете UnonaPay. Средства за товар или услугу будут автоматически списываться с карты вашего клиента так часто, как вы укажете в настройках сервиса, или до тех пор, пока клиент не отменит подписку.
Если требуется управление подписками на вашей стороне, то вы можете реализовать их через механизм нерегулярных платежей по запросу.
Платежи по запросу
Любая схема расчета с проведением платежей по сохраненной карте включает следующие шаги:
-
Клиент указывает данные своей карты при регистрации или в ходе первоначального (инициализирующего рекуррентного) платежа и разрешает торговцу их использовать для оплаты последующих заказов.
-
UnonaPay обрабатывает первоначальный платеж и предоставляет торговцу токен как идентификатор данных карты клиента.
-
Торговец привязывает токен карты к учетной записи клиента и передает его в систему UnonaPay в запросе на проведение рекуррентного платежа для оплаты последующих заказов клиента.
-
UnonaPay обрабатывает запрос на проведение рекуррентного платежа и списывает средства с той карты клиента, токен которой был передан в запросе.
UnonaPay поддерживает разные сценарии и типы операций для проведения платежей по сохраненным данным карты. Пожалуйста, уточните у вашего аккаунт менеджера, какие операции поддерживаются вашим эквайером и могут быть использованы для вашей схемы расчетов и типа интеграции.
Платежи по сохраненным данным карты при использовании платежной страницы или виджета UnonaPay
Если вы используете платежную страницу или виджет UnonaPay, выполните следующие действия:
-
Для проведения первоначального платежа:
- создайте токен платежа и направьте клиента на платежную страницу, или
- создайте виджет.
Передайте подходящее значение для параметра
order.additional_data.contract
. -
Отправьте запрос на списание средств, если вы указывали
authorization
как значение параметраtransaction_type
на шаге 1.Если же вы указывали
charge
как значение этого параметра, то вам не нужно отправлять запрос на списание средств. Система отправляет его автоматически, если запрос на взимание платы был преобразован в операцию авторизации. -
Сохраните токен карты, полученный как значение параметра
token
в автоматическом уведомлении о проведении первоначального платежа, для оплаты последующих заказов клиента. -
Для проведения последующих платежей по сохраненной карте создайте токен платежа или виджет, где укажите токен карты клиента как значение параметра
token
.
Info
Для проверки валидности карты вы можете провести первоначальный платеж на нулевую или минимальную сумму, если такая операция поддерживается вашим эквайером.
При списании минимальной суммы для проверки не забудьте провести возврат средств или отмену авторизации вместо операции списания.
Платежи по сохраненным данным карты при использовании API интеграции
Прежде чем использовать любую из описанных ниже операций, уточните у вашего аккаунт менеджера, поддерживает ли данную операцию ваш эквайер.
Сохранение данных карты до первоначального платежа
Если ваши клиенты сохраняют реквизиты карты при регистрации или до первоначального платежа, отправьте запрос токенизации или получите токен карты при ее сохранении в базе данных системы UnonaPay. Используйте полученный в ответе токен карты для проведения первоначального и последующих платежей.
Info
Обратите внимание! Если вы получили токен карты при ее сохранении в базе данных системы UnonaPay, клиенту может потребоваться пройти авторизацию по протоколу 3-D Secure при проведении первоначального платежа.
Проведение первоначального платежа
Для проведения первоначального платежа отправьте один из следующих запросов:
- операция оплаты;
- операция авторизации с последующим списанием средств;
- запрос на взимание платы.
В запросе для параметра contract
укажите значение recurring
, oneclick
или card_on_file
в зависимости от вашей схемы расчета.
Ответы на запросы стандартны для использованного типа операции и запроса на взимание платы и содержат токен карты как значение параметра token
.
Info
Для проверки валидности карты вы можете провести первоначальный платеж на нулевую или минимальную сумму, если такая операция поддерживается вашим эквайером.
При списании минимальной суммы для проверки не забудьте провести возврат средств для операции оплаты или запроса на взимание средств или отмену авторизации вместо операции списания.
Последующий платеж по сохраненной карте
Для проведения последующего платежа по сохраненным данным карты отправьте один из следующих запросов:
- операция оплаты;
- операция авторизации с последующим списанием средств;
- запрос на взимание платы.
В запросе укажите требуемую сумму заказа и токен карты клиента как значение параметра token
.
Ответы на запросы стандартны для использованного типа операции и запроса на взимание платы.
Возврат средств, списанных платежом по сохраненным данным карты
Чтобы вернуть средства, списанные платежом по сохраненным данным карты, отправьте запрос на возврат средств, где значение параметра uid
укажите как uid
операции платежа или списания или как parent_uid
из ответа системы UnonaPay на запрос на взимание платы.