Точка Банк API: PUT /uapi/webhook/v1.0/{client_id} — Create Webhook

Подключает URL и список событий для приложения. Требуется разрешение ManageWebhookData.

Документация: https://developers.tochka.com/docs/tochka-api/api/create-webhook-webhook-v-1-0-client-id-put

Параметр	Где	Тип	Обяз.	Описание
client_id	path	string	да	Уникальный идентификатор приложения
webhooksList	body	array	да	События: incomingPayment, outgoingPayment, incomingSbpPayment, acquiringInternetPayment, incomingSbpB2BPayment, customWebhook
url	body	string	да	URL для отправки вебхуков, не более 2083 символов

Базовые 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-webhook-webhook-v-1-0-client-id-put Вся интеграция одним документом: https://mcp-everything.ru/integrations/tochka-bank-api.md