Точка Банк API: GET /uapi/acquiring/v1.0/payments — Get Payment Operation List

Возвращает операции по платёжным ссылкам и их статусы. Требуется разрешение ReadAcquiringData; даты периода лучше передавать, чтобы не запрашивать всю историю.

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

Параметр	Где	Тип	Обяз.	Описание
customerCode	query	string	да	Уникальный код клиента
fromDate	query	string	нет	Начало периода создания операций
toDate	query	string	нет	Конец периода создания операций
page	query	integer	нет	Номер страницы, по умолчанию 1
perPage	query	integer	нет	Количество записей на странице, по умолчанию 1000
status	query	string	нет	Статус операции

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