Skip to main content

Оплата картой

Оплата картой — это способ приема платежей с вводом данных карты на платежной форме.

Способ приема платежей по картам подключен по умолчанию.

Особенности способа оплаты

  • Поддержка платежных систем: «Мир», Visa, Mastercard и UnionPay.
  • Эмитент: все российские банки.
  • Срок оплаты: можно настроить от 1 минуты до 90 дней. Значение по умолчанию: 24 часа.
  • Срок холдирования: 7 дней.
  • Минимальная сумма операции: 1 рубль.
  • Поддерживается одно- и двухстадийная оплата.
  • Возврат: частичный и полный.
  • Поддерживаются платежи по сохраненным реквизитам.
  • Отображение в реестре: указывается только название платежной системы и маска карты.

Прием платежей

Принимать платежи по картам можно двумя способами:

  • Одностадийный платеж — мерчант списывает деньги за покупку сразу после завершения оплаты.
  • Двухстадийный платеж — сначала мерчант блокирует деньги за покупку на карте покупателя и только потом списывает их.

По правилам Национальной системы платежных карт (НСПК), холдировать деньги на карте покупателя можно на срок до 7 дней.

Например, покупатель оплатил товар 1 марта, и его банк заморозил деньги на счете. Подтвердить платеж нужно в течение 7 дней, включая день авторизации — то есть до 7 марта включительно. После этого срока деньги на счете покупателя могут быть расхолдированы и покупатель может их потратить — подтвердить списание не получится.

Одностадийный платеж

  1. Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре OperationInitiatorType объекта DATA.
  2. Получите параметр PaymentURL в ответе метода.
  3. Переадресуйте покупателя на PaymentURL — при переходе он увидит платежную форму Т‑Банка для ввода данных карты.
    • При успешном сценарии операция перейдет в статус CONFIRMED, и покупатель будет перенаправлен на страницу SuccessURL.
    • При неуспешном сценарии — в статус AUTH_FAIL, а после трех неудачных попыток оплаты — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.

Двухстадийный платеж

  1. Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре OperationInitiatorType объекта DATA.
  2. Получите параметр PaymentURL в ответе метода.
  3. Переадресуйте покупателя на PaymentURL. При переходе он увидит платежную форму Т‑Банка для ввода данных карты.
    • При успешном сценарии операция перейдет в статус AUTHORIZED, и покупатель будет перенаправлен на страницу SuccessURL.
    • При неуспешном сценарии — в статус AUTH_FAIL, а после трех неудачных попыток оплаты — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.
  4. Вызовите метод Подтвердить списание для подтверждения платежа c параметром PaymentId.
    • При успешном сценарии операция перейдет в статус CONFIRMED.
    • При неуспешном сценарии — в статус AUTH_FAIL, а после трех неудачных попыток оплаты — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.

Передача признака инициатора операции

Платежным системам нужно знать, кем была инициирована карточная операция. За выполнение требований регулятора отвечает параметр OperationInitiatorType в методе Инициировать платеж. Значение этого параметра содержит признаки того, кем была инициирована операция и какой способ предоставления реквизитов был использован.

Полный список значений можно посмотреть в описании метода Инициировать платеж. Для обычных платежей используется только одно значение — OperationInitiatorType=0.

Consumer Initiated (CIT), Credential-Not-Captured — оплата инициирована покупателем, реквизиты карты не сохраняются для последующих платежей.

Работа с картами и покупателями

Покупатели

Используйте методы:

Карты покупателя

При проведении платежей можно сохранять платежные данные покупателя. Это нужно, чтобы при последующих оплатах не приходилось заполнять платежную форму, и покупатель мог сохранять данные своих карт на ней. Для этого покупатель привязывается к терминалу, через который будут проходить платежи.

Есть три способа привязки карты:

Обработка и хранение данных по картам покупателей происходит на стороне Т‑Банка, но для получения информации по картам вы можете использовать методы:

  1. Получить список карт покупателя — для просмотра списка всех привязанных карт покупателя, включая удаленные.
  2. Удалить привязанную карту покупателя — для удаления привязанных карт покупателя.

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

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

openapi@tbank.ru

АО «ТБанк» использует файлы «cookie» с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.