Оплата картой
Оплата картой — это способ приема платежей с вводом данных карты на платежной форме.
- Способ приема платежей по картам подключен по умолчанию.
- Принимать платежи из-за границы можно только в рублях и по картам «Мир» — оплата по картам UnionPay и иностранным картам Visa и MasterCard недоступна. Валюта будет конвертироваться в рубли на момент оплаты по курсу банка, который выпустил карту.
Прием платежей
Принимать платежи по картам можно двумя способами:
- Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
- Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.
По правилам Национальной системы платежных карт (НСПК), холдировать деньги на карте покупателя можно на срок до 7 дней.
Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 7 дней, включая день авторизации — то есть до 7 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.
Одностадийный платеж
- Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре
OperationInitiatorType
объектаDATA
. - Получите параметр
PaymentURL
в ответе метода. - Переадресуйте покупателя на
PaymentURL
— при переходе он увидит платежную форму Т‑Банка для ввода данных карты.- При успешном сценарии операция перейдет в статус
CONFIRMED
, и покупатель будет перенаправлен на страницуSuccessURL
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Список кодов ошибок.
- При успешном сценарии операция перейдет в статус
Двухстадийный платеж
- Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре
OperationInitiatorType
объектаDATA
. - Получите параметр
PaymentURL
в ответе метода. - Переадресуйте покупателя на
PaymentURL
. При переходе он увидит платежную форму Т‑Банка для ввода данных карты.- При успешном сценарии операция перейдет в статус
AUTHORIZED
, и покупатель будет перенаправлен на страницуSuccessURL
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Список кодов ошибок.
- При успешном сценарии операция перейдет в статус
- Вызовите метод Подтвердить списание для подтверждения платежа c параметром
PaymentId
.- При успешном сценарии операция перейдет в статус
CONFIRMED
. - При неуспешном — в статус
REJECTED
, и покупатель будет перенаправлен на страницуFailURL
. Список кодов ошибок.
- При успешном сценарии операция перейдет в статус
Передача признака инициатора операции
Платежным системам нужно знать, кем была инициирована карточная операция. Это особенно важно при проведении операций без 3DS и по сохраненным данным.
За выполнение требований регулятора отвечает параметр OperationInitiatorType
в методе Инициировать платеж. Значение этого параметра содержит признаки того, кем была инициирована операция и какой
способ предоставления реквизитов был использован:
Consumer Initiated (CIT), Credential-Not-Captured — оплата инициирована покупателем, реквизиты карты не сохраняются для последующих платежей.
Работа с картами и покупателями
По умолчанию сохранение карт на платежной форме отключено. Для включения напишите в чат личного кабинета Т‑Бизнеса.
Покупатели
Используйте методы:
- Зарегистрировать клиента — чтобы создать покупателя для привязки платежных данных.
- Получить данные клиента — для просмотра данных покупателя, которые сохранены в связке с терминалом.
- Удалить данные клиента — для отвязывания данных покупателя с платежной формы и терминала.
Карты покупателя
При проведении платежей можно сохранять платежные данные покупателя. Это нужно, чтобы при последующих оплатах не приходилось заполнять платежную форму, и покупатель мог сохранять на ней данные своих карт. Для этого покупатель привязывается к терминалу, через который будут проходить платежи.
Есть три способа привязки карты:
Обработка и хранение данных по картам покупателей происходит на стороне Т‑Банка, но для получения информации по картам вы можете использовать методы:
- Получить список карт клиента — для просмотра списка всех привязанных карт покупателя, включая удаленные.
- Удалить привязанную карту клиента — для удаления привязанных карт покупателя.