Skip to main content

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

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

  • Способ приема платежей по картам подключен по умолчанию.
  • Принимать платежи из-за границы можно только в рублях и по картам «Мир» — оплата по картам UnionPay и иностранным картам Visa и MasterCard недоступна. Валюта будет конвертироваться в рубли на момент оплаты по курсу банка, который выпустил карту.

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

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

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

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

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

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

  1. Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре OperationInitiatorType объекта DATA.
  2. Вызовите метод Проверить версию 3DS. Это нужно для проверки версии протокола 3DS. Она может быть версии 1.0 или 2.0.
  3. Вызовите метод Пройти этап 3DS Method.
  4. Вызовите метод Подтвердить платеж.
    • Если проверку 3DS проходить не нужно, то при успешном сценарии операция перейдет в статус CONFIRMED, и покупатель будет перенаправлен на страницу SuccessURL.
    • Если проверку 3DS проходить нужно, то при успешном сценарии операция перейдет в статус 3DS_CHECKING, и в ответе вернется параметр ACSUrl.
    • При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.
  5. Вызовите метод Отправить запрос в банк-эмитент для прохождения 3DS и перенаправьте покупателя для прохождения 3DS на страницу банка-эмитента из параметра ACSUrl, полученного в пункте 4.
  6. После получения ответа от ACS с результатами прохождения 3DS вызовите метод Подтвердить прохождение 3DS v. 1.0 или Подтвердить прохождение 3DS v. 2.1 — в зависимости от версии протокола 3DS.
    • При успешном сценарии операция перейдет в статус CONFIRMED, и покупатель будет перенаправлен на страницу SuccessURL.
    • При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок и возможные Ошибки 3DS.

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

  1. Вызовите метод Инициировать платеж. Обязательно передайте признак инициатора операции в параметре OperationInitiatorType объекта DATA.
  2. Вызовите метод Проверить версию 3DS. Это нужно для проверки версии протокола 3DS. Она может быть версии 1.0 или 2.0.
  3. Вызовите метод Пройти этап 3DS Method.
  4. Вызовите метод Подтвердить платеж.
    • Если проверку 3DS проходить не нужно, то при успешном сценарии операция перейдет в статус AUTHORIZED, и покупатель будет перенаправлен на страницу SuccessURL.
    • Если проверку 3DS проходить нужно, то при успешном сценарии операция перейдет в статус 3DS_CHECKING, и в ответе вернется параметр ACSUrl.
    • При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок.
  5. Вызовите метод Отправить запрос в банк-эмитент для прохождения 3DS и перенаправьте покупателя для прохождения 3DS на страницу банка-эмитента из параметра ACSUrl, полученного в пункте 4.
  6. После получения ответа от ACS с результатами прохождения 3DS вызовите метод Подтвердить прохождение 3DS v. 1.0 или Подтвердить прохождение 3DS v. 2.1 — в зависимости от версии протокола 3DS.
    • При успешном сценарии операция перейдет в статус AUTHORIZED, и покупатель будет перенаправлен на страницу SuccessURL.
    • При неуспешном — в статус REJECTED, и покупатель будет перенаправлен на страницу FailURL. Список кодов ошибок и возможные Ошибки 3DS.
  7. Вызовите метод Подтвердить списание для подтверждения платежа c параметром PaymentId.

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

Платежным системам нужно знать, кем была инициирована карточная операция. Это особенно важно при проведении операций без 3DS и по сохраненным данным.

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

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

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

По умолчанию сохранение карт на платежной форме отключено. Для включения напишите в чат личного кабинета Т‑Бизнеса.

Покупатели

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

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

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

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

  1. Без платежа — покупатель и его карты будут сохранены до проведения платежа.
  2. Без проверки 3DS — покупатель и его карты будут сохранены без подтверждения, но оно понадобится при первом платеже по сохраненной карте.
  3. С проверкой 3DS — покупатель должен будет подтвердить операцию на этапе сохранения карты. Все дальнейшие платежи будут проходить по схеме дочернего COF-платежа, то есть подтверждать каждое списание не нужно.

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

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

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

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

openapi@tbank.ru

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