Платежи по сохраненным реквизитам

Платеж по сохраненным реквизитам — это оплата, при которой покупателю не нужно каждый раз вводить реквизиты карты. Для такой оплаты есть два типа платежа:

CC, родительский платеж — операция с сохранением реквизитов карты для будущих оплат. Требует ввода реквизитов. Может быть проведена для полноценной покупки или операции привязки без списания средств.
COF, дочерний платеж — оплата с использованием ранее сохраненных реквизитов.

Общая схема проведения платежа по сохраненным реквизитам

Родительские платежи

Родительская операция подтверждает согласие держателя карты на сохранение реквизитов и определяет порядок их последующего использования.

Родительская CC-операция может быть двух типов:

CC-покупка — стандартная оплата товара или услуги, в рамках которой дополнительно сохраняются реквизиты карты. Предполагает списание средств.
CC-привязка — операция проверки и сохранения реквизитов карты без оплаты товара или услуги. Средства временно блокируются на карте покупателя на момент проведения проверки.

Дочерние платежи

Основные характеристики COF-операций по сохраненным реквизитам — инициатор и периодичность. Типы дочерних COF-операций:

CIT COF — покупатель сам инициирует оплату, но не вводит реквизиты карты, так как они сохранены заранее. Платеж разовый.
MIT COF Recurring — повторяющийся платеж, инициированный магазином без участия покупателя. Например, подписка или регулярные списания по событию. Платеж регулярный, без фиксированного графика.
MIT COF Installment — платеж по графику: магазин делит сумму на части и списывает их по расписанию. Например, рассрочка. Платеж регулярный, по установленному графику.
MIT COF Delayed-Charge — отсроченное списание: дополнительные требования оплаты после основного расчета. Например, доначисления после check-out в отеле. Платеж, выполняемый однократно или несколько раз в течении ограниченного периода времени.
MIT COF No-Show — плата за неявку: фиксированное списание за забронированную, но неиспользованную услугу. Например, номер в отеле. Платеж, выполняемый однократно или несколько раз в течении ограниченного периода времени.

Условия использования

По умолчанию возможность проведения платежей по сохраненным реквизитам отключена. Чтобы ее включить:

на DEMO-терминале — напишите на acq_help@tbank.ru;
на боевом терминале — обратитесь к своему персональному менеджеру.

Сценарии платежей по сохраненным реквизитам подходят при оплате через T-Pay и MIR Pay.

Тип операции	ECOM-терминал	Требует подтверждения по CC-операции
CIT COF	Да	Нет
MIT COF Recurring	Да	Нет
MIT COF Installment	Да	Нет
MIT COF Delayed-Charge	Да ¹	Да ²
MIT COF No-Show	Да ¹	Да ²

¹ Чтобы уточнить возможность использования этих типов операций и их подключения, обратитесь к своему персональному менеджеру.
² Проводить COF-платежи по сценариям MIT COF Delayed-Charge и MIT COF No-Show можно, если есть родительская CC-операция в формате покупки с подтверждением через метод Подтвердить списание. Поэтому использовать операцию привязки карты в качестве CC-операции нельзя.

Схема проведения платежа по сохраненным реквизитам

Платежи по сохраненным реквизитам проводятся последовательно в два этапа:

Проводится один из двух типов родительской операции — CC-покупка/CC-привязка.
После авторизации мерчант получает RebillId в уведомлении — уникальный идентификатор сохраненных реквизитов карты покупателя.
С использованием полученного RebillId проводится дочерний (COF) платеж.

В зависимости от выбранного типа операции последовательно вызываются методы:

Тип операции	Последовательность методов
CC-покупка	Не отличается от стандартного платежа — за исключением того, что в методе Инициировать платеж нужно передать параметр `Recurrent=Y`.
CC-привязка	Инициировать привязку карты к клиенту Привязать карту
COF-операция	Для проведения списания мерчант вызывает метод Инициировать платеж и указывает сумму платежа в параметре `Amount`. Без переадресации на `PaymentURL` вызывает метод Провести платеж по сохраненным реквизитам для оплаты по тем же реквизитам и в нем передает параметр `RebillId`, полученный при совершении CC-операции.

Логика одностадийных и двухстадийных платежей распространяется на CC- и COF-покупки. Для привязок логика не применяется, так как в этом сценарии нет подтверждения списания средств через метод Подтвердить списание.

Для CC-операций применяется стадийность, указанная в личном кабинете интернет-эквайринга или переданная в параметре PayType в запросе метода Инициировать платеж.

Для COF-операций также можно выбрать стадийность оплаты через передачу параметра PayType в запросе метода Инициировать платеж или задать поведение по умолчанию на уровне терминала — для этого обратитесь на acq_help@tbank.ru с просьбой переключить схему стадийности платежей по сохраненным реквизитам.

Ключевые параметры COF-операций

Тип COF-операции указывается в атрибуте OperationInitiatorType метода Инициировать платеж.

Тип операции	OperationInitiator в методе Инициировать платеж
CIT COF	2
MIT COF Recurring	R
MIT COF Installment	I
MIT COF Delayed-Charge	D
MIT COF No-Show	N

Через СБП

Автоплатеж через СБП — это повторный платеж, который автоматически списывается с привязанного счета по QR. В отличие от автоплатежей по картам, у автоплатежа по СБП нет родительского платежа — вместо него привязывается счет.

Автоплатежи через СБП работают только по одностадийной схеме оплаты. Для их проведения нужно дополнительно настроить оплату через СБП по API — в личном кабинете интернет-эквайринга перейдите в раздел Магазины и на вкладке Способы оплаты в разделе Своя платежная форма включите систему быстрых платежей.

Проводятся последовательно в два этапа:

Привязка счета.
Автоплатеж, когда мерчант списывает деньги со счета без участия покупателя.

С привязкой счета до оплаты

Привяжите счет — вызовите метод Привязать счет к магазину.
На NotificationURL в уведомлении о привязке счета вернется параметр AccountToken — он будет отвечать за последующие повторные списания. Сохраните его.
Уведомление с AccountToken придет на URL, который установлен в настройках терминала, а не на переданный в методе Инициировать платеж.
Вызовите метод Инициировать платеж с указанием дополнительных параметров Recurrent=Y и DATA={"QR":"true"} для получения параметра PaymentId.
Вызовите метод Автоплатеж по QR с параметром AccountToken, который вы сохранили на шаге 2.

С привязкой счета после оплаты

Вызовите метод Инициировать платеж с указанием дополнительных параметров Recurrent=Y, DATA={"QR":"true"} и обязательной передачей параметра Description с описанием заказа.
Вызовите метод Сформировать QR и проведите оплату.
После успешной оплаты в уведомлении или ответе метода Сформировать QR вернется параметр RequestKey — он отвечает за привязку счета.
Вызовите метод Получить статус привязки счета к магазину и передайте параметр RequestKey из пункта 3. Это нужно для проверки статуса привязки счета клиента по магазину.
На NotificationURL в уведомлении о привязке счета вернется параметр AccountToken — он будет отвечать за последующие повторные списания. Сохраните его.
Уведомление с AccountToken вернется на URL, который установлен в настройках терминала, а не на переданный в методе Инициировать платеж.
После успешной привязки счета проведите автоплатеж — вызовите метод Автоплатеж по QR с параметром AccountToken, который вы сохранили на шаге 5.

Особенности привязки счета при наличии нескольких терминалов

Если счет привязан к одному из ваших терминалов, автоплатежи будут выполняться на всех ваших терминалах.

Схема работы:

У вас есть терминалы А и Б. Ранее покупатель проводил оплату только по терминалу А.
Вы пробует провести автоплатеж по терминалу Б.
Банк проверяет наличие привязки к терминалу Б.
Если привязки к этому терминалу нет, банк проверяет ее наличие на других ваших терминалах по идентификатору магазина.
Банк успешно находит привязку по терминалу А и разрешает проведение автоплатежа.