Т‑Касса: POST /v2/Init — Инициировать платеж

Создает платеж в статусе NEW и возвращает PaymentId; при использовании формы Т‑Банка также возвращает PaymentURL.

Документация: https://developer.tbank.ru/eacq/api/init

Параметр	Где	Тип	Обяз.	Описание
`TerminalKey`	body	string	да	Идентификатор терминала, до 64 символов
`Amount`	body	integer	да	Сумма в копейках
`OrderId`	body	string	да	Уникальный для каждой операции идентификатор заказа, до 50 символов
`Token`	body	string	да	Подпись запроса
`Description`	body	string	нет	Описание заказа на платежной форме
`CustomerKey`	body	string	нет	Идентификатор покупателя; обязателен для карточного платежа с Recurrent=Y
`Recurrent`	body	string	нет	Y для родительского платежа с сохранением реквизитов
`PayType`	body	string	нет	O — одностадийная, T — двухстадийная оплата
`NotificationURL`	body	string	нет	URL для POST-уведомлений
`SuccessURL`	body	string	нет	URL возврата покупателя после успешной оплаты
`FailURL`	body	string	нет	URL возврата покупателя после неуспешной оплаты
`RedirectDueDate`	body	string	нет	Срок жизни платежной ссылки
`DATA.OperationInitiatorType`	body	string	нет	Инициатор операции: 0, 1, 2, R, I, D или N
`Receipt`	body	object	нет	Данные чека; обязателен при подключенной онлайн-кассе

Пример ответа:

{
  "Success": true,
  "ErrorCode": "0",
  "TerminalKey": "TBankTest",
  "Status": "NEW",
  "PaymentId": "3093639567",
  "OrderId": "21090",
  "Amount": 140000,
  "PaymentURL": "https://pay.tbank.ru/new/fU1ppgqa"
}

Базовые URL

Боевой: https://securepay.tinkoff.ru/v2
Тестовый: https://rest-api-test.tinkoff.ru/v2

Авторизация

Тип: Другое

Для каждого подписываемого запроса передавай TerminalKey и Token в корневом JSON-объекте. TerminalKey и секретный Password находятся в личном кабинете интернет-эквайринга; Password в запрос не передается.

Чтобы получить Token, собери корневые параметры запроса, добавь к ним Password, исключи Token, вложенные объекты и массивы, отсортируй пары по имени ключа, склей только значения и вычисли SHA-256 в UTF‑8. Полученную шестнадцатеричную строку передай в Token.

Нюансы

Все методы используют POST с JSON; имена методов и параметров чувствительны к регистру. Передавай Content-Type: application/json и используй TLS 1.2 или выше.
Суммы передаются в копейках, интернет-эквайринг принимает оплату только в рублях. В POST /v2/Init сумма Amount должна совпадать с суммой Receipt.Items.Amount.
HTTP 200 не гарантирует успех операции: проверяй Success, ErrorCode и Status. OpenAPI описывает успешный и ошибочный ответ как варианты одного ответа 200.
Не включай в расчет Token вложенные объекты и массивы, в том числе DATA и Receipt. Password добавляется только при расчете подписи и не отправляется.
Не считай редирект на SuccessURL подтверждением оплаты. Проверь уведомление или POST /v2/GetState и обязательно сравни Amount с ожидаемой суммой заказа.
Перед обработкой уведомления проверь его Token. Ответ должен быть HTTP 200 с телом OK заглавными английскими буквами; ожидание ответа — 10 секунд.
Если OK не получен, уведомление повторяется раз в час в течение 24 часов, затем раз в сутки в течение месяца. Архив уведомлений хранится 90 дней.
Для двухстадийной оплаты POST /v2/Confirm вызывается только в статусе AUTHORIZED; подтвердить карточный платеж нужно в течение 7 дней, включая день авторизации.
Возможность платежей по сохраненным реквизитам по умолчанию выключена. RebillId нужно брать только из проверенного уведомления родительского платежа.
Тестовая среда требует добавления IP в белый список. Для нее используется боевой терминал без приставки DEMO; тест-кейсы с DEMO-терминалом, наоборот, отправляются на боевой URL.

Сценарии с этим методом

Если этого недостаточно — официальная документация: https://developer.tbank.ru/eacq/api/init Вся интеграция одним документом: https://mcp-everything.ru/integrations/t-kassa-api.md