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