Платежи

C помощью платёжных методов API вы можете:

выполнять массовые платежи по реквизитам своим контрагентам — юридическим и физическим лицам;
оплачивать налоги и иные платежи в бюджет;
совершать оплату на карту T‑Банка;
создать черновик платёжного поручения для выплат в бюджет и контрагентам.

Отправить платёж

Чтобы отправлять платежи:

Убедитесь, что у пользователя есть доступы для совершения платежей.
Для этого в личном кабинете перейдите в Профиль → Компании и выберите нужного пользователя в разделе Доступы → Пользователи. Проверьте наличие подписи на вкладке Право подписи. Как добавить сотрудника и дать право подписи.
Выпустите токен с разрешениями:
- Для метода Выполнить платёж — Совершение платежей с рублевого расчётного счёта компании с ИНН {inn} и КПП {kpp}.
- Для метода Выполнить платёж на карту T‑Банка — Совершение платежей физическим лицам с рублёвого расчётного счёта компании с ИНН {inn} и КПП {kpp} на карту T‑Банка.
  
  Подробнее о выпуске токена
Выпустите сертификат. Подробнее о выпуске сертификата.

Токен и сертификат привязываются после первого успешного запроса. Если вы хотите перевыпустить токен, вам также нужно перевыпустить сертификат.

Чтобы обезопасить платежи, установите два вида лимитов:
- Лимиты ЭЦП — распространяются на все платежи вне зависимости от интерфейса: веб, мобильное приложение, API. Можно настроить несколькими способами:
  - Пользователь с ролью «Генеральный директор» изменяет лимиты самостоятельно в личном кабинете T‑Бизнеса в разделе Лимиты.
  - Через персонального менеджера.
- Лимиты T‑API — распространяются только на платежи через интерфейс T‑API. Лимиты по умолчанию:
  - максимальная сумма одного платежа — 100 000 рублей;
  - максимальная сумма платежей в день — 100 000 рублей;
  - максимальная сумма платежей в месяц — 1 000 000 рублей;
  - максимальное количество платежей в день на одного контрагента — 3.

Чтобы повысить лимиты, отправьте письмо с вашей корпоративной почты на openapi@tinkoff.ru. В письме укажите новые значения и пользователей, для которых нужно повысить лимиты.

Платежи по реквизитам юридических и физических лиц и в бюджет

Используйте метод Выполнить платёж.

ID — уникальный идентификатор для всех платежей вашей компании, отправленных через T‑API. Для каждого запроса используется свой ID. Если вы отправите несколько запросов с одним ID, создастся только один платёж.

Примеры запросов

"id": "123.pay",
"from": {
    "accountNumber": "40703810987687654321"
},
"to": {
    "name": "Иванов В.В.",
    "inn": "0",
    "bik": "044525974",
    "bankName": "АО "ТИНЬКОФФ БАНК"",
    "corrAccountNumber": "30101810145250000974",
    "accountNumber": "40817810900987654321"
},
"purpose": "//ВЗС//500-00// Выплата заработной платы (30000 руб.) Иванову В.В. за июль 2022 года по ведомости от 30.06.20 №5. НДС не облагается",
"documentNumber": 100,
"executionOrder": 5,
"amount": 30000,
"dueDate": "2022-07-01T00:00+03:00",
"revenueTypeCode": "1",
"collectionAmount": 500,

Платёж на карту T‑Банка

Используйте метод Выполнить платёж на карту T‑Банка.

Уточните номер договора у получателя. Как посмотреть реквизиты и номер договора.

Пример запроса

"id": "123.card",
"from": {
    "accountNumber": "40703810987687654321"
},
"to": {
    "agreementNumber": "7000368800"
},
"purpose": "Оплата по договору №123. НДС не облагается",
"amount": 10,
"dueDate": "2021-06-20T00:00:00Z"

Платёж считается отправленным, если в ответ на вызов метода вы получаете ответ 201 с указанием X-Request-Id в headers. Сохраните идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке платежа.

Количество запросов в секунду (RPS (requests per second)) для метода — 10. Если вам нужно увеличить количество, напишите нам на openapi@tinkoff.ru.

Проверить статус отправленного платежа

Используйте метод Получить статус платежа, передав уникальный ID операции. При успешном запросе возвращается ответ 200.

"status": "EXECUTED"

Количество запросов в секунду (RPS (requests per second)) для метода — 20. Если вам нужно увеличить количество, напишите нам на openapi@tinkoff.ru.

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

"paymentId": "payment_id_123",
"status": "EXECUTED"

Публичная ручка должна быть без авторизации. Фильтровать события можно по IP-адресу, который мы вам сообщим. По всем вопросам обращайтесь на openapi@tinkoff.ru

Черновики платёжных поручений

Чтобы создавать черновики платёжных поручений, выпустите токен с разрешением Создание черновиков платежей в компании с ИНН {inn} и КПП {kpp} для метода Создать черновик платёжного поручения.

Подробнее о выпуске токена

Создать черновик на оплату по реквизитам юридических и физических лиц и в бюджет

Используйте метод Создать черновик платёжного поручения.

Примеры запросов

"documentNumber": "654321",
  "date": "2022-10-03T12:30+03:00[Europe/Moscow]",
  "amount": 500,
  "recipientName": "Петров Петр Петрович",
  "inn": "987654321987",
  "kpp": "0",
  "bankAcnt": "4081781090098765432",
  "bankBik": "044525974",
  "accountNumber": "40703810987687654321",
  "paymentPurpose": "Оплата товара #123. Без НДС",
  "executionOrder": 5,
  "taxPayerStatus": "0",
  "kbk": "0",
  "oktmo": "0",
  "taxEvidence": "0",
  "taxPeriod": "0",
  "uin": "0",
  "taxDocNumber": "0",
  "taxDocDate": "0",
  "recipientCorrAccountNumber": "30101810145250000974"

Черновик считается созданным, если в ответ на вызов метода возвращается ответ 200 с указанием X-request-id в headers. Сохраните идентификатор — по нему банк сможет провести анализ, если у вас возникнут вопросы по отправке черновика.

Подписать отправленный черновик

Только для Партнёрского сценария.

Перенаправьте пользователя по ссылке,

https://business.tbank.ru/sme/ruble/payment?id=<documentId>&returnApp=rko&returnPath=%2Fdashboard%3Foperations%3Ddrafts

где id=<documentId> — ID черновика.

После авторизации в личном кабинете откроется экран платежа с возможностью подтверждения.

Примеры ошибок при вызове методов

Посмотреть примеры часто встречающихся ошибок можно также в документации T‑API.

400

401

403 Ошибки доступов — права пользователя, сертификаты, токены

errorCode: FORBIDDEN