Точка Банк API: POST /uapi/acquiring/v1.0/payments — Create Payment Operation

Создаёт платёжную ссылку и возвращает operationId. Требуется разрешение MakeAcquiringOperation.

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

Параметр	Где	Тип	Обяз.	Описание
Data.customerCode	body	string	да	Уникальный код клиента, 9 символов
Data.amount	body	number	да	Сумма платежа, больше 0
Data.purpose	body	string	да	Назначение платежа, не более 140 символов
Data.paymentMode	body	array	да	Способы оплаты: sbp, card, tinkoff, dolyame
Data.redirectUrl	body	string	нет	URL после оплаты
Data.failRedirectUrl	body	string	нет	URL после неуспешной оплаты
Data.merchantId	body	string	нет	Идентификатор торговой точки, 15 символов
Data.preAuthorization	body	boolean	нет	Создать платёж с двухэтапной оплатой
Data.ttl	body	integer	нет	Время жизни ссылки в минутах, от 1 до 44640; по умолчанию 10080
Data.paymentLinkId	body	string	нет	Уникальный номер заказа, не более 45 символов

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