Точка Банк API: POST /uapi/payment/v1.0/for-sign — Create Payment For Sign

Создаёт платёжное поручение в разделе «На подпись» и возвращает ссылку на его подписание. Требуется разрешение CreatePaymentForSign.

Документация: https://developers.tochka.com/docs/tochka-api/api/create-payment-for-sign-payment-v-1-0-for-sign-post

Параметр	Где	Тип	Обяз.	Описание
Data.accountCode	body	string	да	Номер счёта отправителя, 20 символов
Data.bankCode	body	string	да	БИК отправителя, 9 символов
Data.counterpartyBankBic	body	string	да	БИК получателя, 9 символов
Data.counterpartyAccountNumber	body	string	да	Счёт получателя, 20 символов
Data.counterpartyName	body	string	да	Получатель платежа
Data.paymentAmount	body	number	да	Сумма платежа
Data.paymentDate	body	string	да	Дата платежа по ISO 8601, приведённая к часовому поясу Москвы
Data.paymentPurpose	body	string	да	Назначение платежа, не более 210 символов
Data.payerINN	body	string	нет	Обязательно при платеже за третье лицо
Data.payerKPP	body	string	нет	Обязательно в указанных документацией бюджетных платежах и платежах за нерезидента
Data.paymentPriority	body	string	нет	Очерёдность платежа; значение по умолчанию — 5

Базовые URL

• Боевой: https://enter.tochka.com/uapi
• Тестовый: https://enter.tochka.com/sandbox/v2
• OAuth 2.0: https://enter.tochka.com/connect/token
• В песочнице часть пути после сохраняется: /uapi

Авторизация

Тип: Bearer-токен

Для интеграции одной компании создай JWT-ключ в интернет-банке: «Сервисы» → «Интеграции и API» → «Создать JWT-ключ». Выбери срок и разрешения, сохрани токен и client_id, затем передавай Authorization: Bearer <jwt_token>. У JWT нет refresh-токена; после истечения срока ключ перевыпускается вручную.

Для сервиса, который работает от имени других компаний, используется OAuth 2.0: зарегистрируй приложение, получи служебный токен по client_credentials, создай consent, отправь клиента на подтверждение, обменяй code на access_token и refresh_token. code живёт 5 минут, access_token — 24 часа, refresh_token — 30 дней; при запросе данных конкретной компании дополнительно передавай её идентификатор в заголовке customerCode.

В песочнице используй Authorization: Bearer sandbox.jwt.token; отдельные ключи и доступы для неё не нужны.

Нюансы

• Init Statement работает асинхронно. Созданная выписка доступна 24 часа, затем удаляется; в неё попадают только операции в финальном статусе.
• В выписке creditDebitIndicator: Credit означает приход, Debit — расход. Если transactionTypeCode ещё содержит мемориальный ордер, документация советует через несколько секунд сформировать выписку повторно.
• Платёж, созданный через API, обязательно подписывает сотрудник в интернет-банке. Подписанный вне операционного времени или в выходной платёж отправится в ближайший рабочий день.
• Если платёж после создания через API отредактировали в интернет-банке, Get Payment Status перестаёт показывать актуальный статус и остаётся в Created.
• Если торговых точек несколько, для платёжной ссылки обязательно передавай merchantId. Рабочая торговая точка должна иметь status: "REG" и isActive: true.
• Возврат через API возможен только из статуса APPROVED. Оплату цифровым рублём через API вернуть нельзя; возврат оформляется вручную в интернет-банке.
• Вебхук приходит как строка JWT с Content-Type: text/plain и подписью RS256. Проверяй подпись публичным ключом https://enter.tochka.com/doc/openapi/static/keys/public до обработки данных.
• Вебхуки отправляются только об успешных операциях. Если события нет, проверь платёж через соответствующий метод статуса или выписку.
• При перевыпуске JWT меняются и токен, и client_id; старые значения удаляются. Обнови ключ в интеграции и настройки вебхуков.
• Песочница возвращает фиксированные ответы независимо от входных значений. Переход и реальная оплата по платёжной ссылке в ней недоступны.

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

• Подготовить и отправить исходящий платёж

---

Если этого недостаточно — официальная документация: https://developers.tochka.com/docs/tochka-api/api/create-payment-for-sign-payment-v-1-0-for-sign-post Вся интеграция одним документом: https://mcp-everything.ru/integrations/tochka-bank-api.md