Т‑Касса: POST /v2/Confirm — Подтвердить списание

Списывает всю или часть заблокированной суммы двухстадийного платежа. Метод применим только к платежу в статусе AUTHORIZED.

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

Параметр	Где	Тип	Обяз.	Описание
TerminalKey	body	string	да	Идентификатор терминала, до 64 символов
PaymentId	body	string	да	Идентификатор платежа, до 20 символов
Token	body	string	да	Подпись запроса
IP	body	string	нет	IP-адрес покупателя
Amount	body	integer	нет	Сумма списания в копейках; без поля используется исходная сумма
Receipt	body	object	нет	Данные чека; обязателен при подключенной онлайн-кассе

Базовые 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/confirm Вся интеграция одним документом: https://mcp-everything.ru/integrations/t-kassa-api.md