Точка Банк API API

Отрасль: Платежи и финансы. Актуально на 2026-10-13.

API для работы с банковскими счетами бизнеса: балансами, выписками, исходящими платежами, интернет-эквайрингом и уведомлениями. Эта запись покрывает основные цепочки от авторизации до получения результата; для каждой операции нужны соответствующие разрешения.

Охват

Есть:

Остатки по счетам
Формирование и получение выписки
Создание исходящего платежа на подпись и проверка его статуса
Платёжные ссылки интернет-эквайринга, проверка оплаты и возврат
Подключение вебхуков
JWT, OAuth 2.0 и песочница

Нет — смотри официальную документацию:

Подробные данные счетов и клиентов
QR-коды СБП, B2B-платежи и возвраты СБП
Выставление счетов и закрывающие документы
Подписки и рекуррентные платежи
Реестры интернет-эквайринга и управление торговыми точками

Сценарии

Получить остатки по всем счетам

Подходит для дашборда или сверки доступных средств. В результате приходит массив Data.Balance с отдельными элементами по счетам и типам баланса.

Получи JWT с разрешением ReadBalances или OAuth-токен с этим разрешением.
Запроси остатки: GET /uapi/open-banking/v1.0/balances.
Для доступного остатка выбери элементы с type: "ClosingAvailable"; сумма и валюта находятся в Amount.amount и Amount.currency.

curl -L 'https://enter.tochka.com/uapi/open-banking/v1.0/balances' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Получить выписку по счёту

Выписка формируется асинхронно. Сначала создаётся ресурс выписки, затем по statementId запрашивается статус и готовый список операций.

Получи токен с разрешениями ReadAccountsBasic, ReadAccountsDetail и ReadStatements.
Запроси GET /uapi/open-banking/v1.0/accounts и выбери accountId нужного счёта.
Запусти формирование: POST /uapi/open-banking/v1.0/statements с Data.Statement.accountId, Data.Statement.startDateTime и Data.Statement.endDateTime.
Возьми Data.Statement.statementId из ответа.
Запрашивай GET /uapi/open-banking/v1.0/accounts/{accountId}/statements/{statementId}, пока Data.Statement[].status не станет Ready.
Забери остатки периода и массив Data.Statement[].Transaction.

curl -L 'https://enter.tochka.com/uapi/open-banking/v1.0/statements' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "Data": {
      "Statement": {
        "accountId": "40817810802000000008/044525104",
        "startDateTime": "2019-01-01",
        "endDateTime": "2019-01-01"
      }
    }
  }'

curl -L 'https://enter.tochka.com/uapi/open-banking/v1.0/accounts/40817810802000000008/044525104/statements/123243234' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

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

API создаёт платёжное поручение, но не списывает деньги сам. Сотрудник с правом подписи должен перейти по Data.redirectURL и подтвердить платёж смс-кодом.

Получи токен с разрешением CreatePaymentForSign.
Создай платёж: POST /uapi/payment/v1.0/for-sign с реквизитами отправителя, получателя, суммой, датой и назначением.
Сохрани Data.requestId и перенаправь сотрудника по Data.redirectURL для подписи.
Проверяй результат: GET /uapi/payment/v1.0/status/{requestId}, пока платёж не перейдёт в Paid, Canceled или Rejected.

curl -L 'https://enter.tochka.com/uapi/payment/v1.0/for-sign' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "Data": {
      "accountCode": "40702810840020002503",
      "bankCode": "044525104",
      "counterpartyBankBic": "044525104",
      "counterpartyAccountNumber": "40702810840020002504",
      "counterpartyName": "ООО \"БАЙКАЛ-СЕРВИС ТК\"",
      "paymentAmount": 700.33,
      "paymentDate": "2018-03-29",
      "paymentPurpose": "Оплата по счету № 1 от 01.01.2021. Без НДС"
    }
  }'

curl -L 'https://enter.tochka.com/uapi/payment/v1.0/status/openapi-b96d770e-769f-49ce-9630-890e00d47720' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Принять оплату по платёжной ссылке

Сценарий для оплаты заказа картой, через СБП, T-Pay или «Долями». Метод возвращает Data.paymentLink для покупателя и Data.operationId для контроля операции.

Подключи интернет-эквайринг и получи токен с разрешениями MakeAcquiringOperation, ReadAcquiringData и ReadCustomerData.
Запроси GET /uapi/open-banking/v1.0/customers и возьми customerCode из объекта с customerType: "Business".
Если торговых точек несколько, запроси GET /uapi/acquiring/v1.0/retailers с customerCode и выбери merchantId точки с status: "REG" и isActive: true.
Создай ссылку: POST /uapi/acquiring/v1.0/payments.
Перенаправь покупателя по Data.paymentLink и сохрани Data.operationId.
Дождись вебхука acquiringInternetPayment или проверь операцию: GET /uapi/acquiring/v1.0/payments/{operationId}. Успешной оплате соответствует APPROVED.

curl -L 'https://enter.tochka.com/uapi/acquiring/v1.0/payments' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "Data": {
      "customerCode": "300000092",
      "amount": "1234.00",
      "purpose": "Перевод за оказанные услуги",
      "redirectUrl": "https://example.com",
      "failRedirectUrl": "https://example.com/fail",
      "paymentMode": [
        "sbp",
        "card",
        "tinkoff",
        "dolyame"
      ]
    }
  }'

Вернуть оплату по платёжной ссылке

Возврат может быть полным или частичным, но доступен только для операции в статусе APPROVED. Результат запроса содержит Data.isRefund, сумму и идентификатор операции возврата.

Получи токен с разрешениями ReadAcquiringData и MakeAcquiringOperation.
Возьми operationId из вебхука acquiringInternetPayment или найди операцию через GET /uapi/acquiring/v1.0/payments с customerCode и датами периода.
Запроси GET /uapi/acquiring/v1.0/payments/{operationId} и убедись, что статус операции — APPROVED.
Выполни возврат: POST /uapi/acquiring/v1.0/payments/{operationId}/refund с суммой не больше суммы оплаты.

curl -L 'https://enter.tochka.com/uapi/acquiring/v1.0/payments/48232c9a-ce82-1593-3cb6-5c85a1ffef8f/refund' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "Data": {
      "amount": "1234.00"
    }
  }'

Получать уведомления о платежах

Вебхук избавляет от постоянного опроса API. Точка отправляет на заданный URL подписанную строку JWT при выбранных успешных событиях.

Получи токен с разрешением ManageWebhookData и сохрани client_id.
Подними HTTPS-обработчик на порту 443: он должен принимать Content-Type: text/plain, проверять подпись JWT публичным ключом Точки и возвращать HTTP 200.
Подключи события: PUT /uapi/webhook/v1.0/{client_id}. При создании банк отправит по одному тестовому событию каждого выбранного типа.
После проверки подписи обрабатывай incomingPayment, outgoingPayment, incomingSbpPayment, incomingSbpB2BPayment или acquiringInternetPayment.

curl -L -X PUT 'https://enter.tochka.com/uapi/webhook/v1.0/4ZY5qFuPsWdz3BfcG1RR5F4ZWOOCwLFI' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -d '{
    "webhooksList": [
      "incomingPayment"
    ],
    "url": "https://example.com"
  }'

Базовые 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; отдельные ключи и доступы для неё не нужны.

Методы

GET /uapi/open-banking/v1.0/accounts — Get Accounts List

Возвращает список счетов и их accountId. Требуются разрешения ReadAccountsBasic, ReadAccountsDetail.

Документация: https://developers.tochka.com/docs/tochka-api/api/get-accounts-list-open-banking-v-1-0-accounts-get

GET /uapi/open-banking/v1.0/balances — Get Balances List

Возвращает остатки по всем счетам организации. Требуется разрешение ReadBalances.

Документация: https://developers.tochka.com/docs/tochka-api/api/get-balances-list-open-banking-v-1-0-balances-get

POST /uapi/open-banking/v1.0/statements — Init Statement

Асинхронно запускает формирование выписки и возвращает statementId. Требуется разрешение ReadStatements.

Документация: https://developers.tochka.com/docs/tochka-api/api/init-statement-open-banking-v-1-0-statements-post

Параметр	Где	Тип	Обяз.	Описание
`Data.Statement.accountId`	body	string	да	Уникальный и неизменный идентификатор счёта, не более 40 символов
`Data.Statement.startDateTime`	body	string	да	Дата начала выписки, ISO 8601
`Data.Statement.endDateTime`	body	string	да	Дата окончания выписки, ISO 8601

GET /uapi/open-banking/v1.0/accounts/{accountId}/statements/{statementId} — Get Statement

Возвращает состояние и содержимое конкретной выписки. В выписку входят только операции в финальном статусе.

Документация: https://developers.tochka.com/docs/tochka-api/api/get-statement-open-banking-v-1-0-accounts-account-id-statements-statement-id-get

Параметр	Где	Тип	Обяз.	Описание
`accountId`	path	string	да	Идентификатор счёта
`statementId`	path	string	да	Идентификатор выписки

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

GET /uapi/payment/v1.0/status/{requestId} — Get Payment Status

Показывает этап платежа: WaitingForCreate, Created, Paid, Canceled или Rejected. Требуются разрешения CreatePaymentForSign, CreatePaymentOrder.

Документация: https://developers.tochka.com/docs/tochka-api/api/get-payment-status-payment-v-1-0-status-request-id-get

Параметр	Где	Тип	Обяз.	Описание
`requestId`	path	string	да	Идентификатор запроса из ответа Create Payment For Sign

GET /uapi/open-banking/v1.0/customers — Get Customers List

Возвращает доступные компании и их customerCode; для банковских операций нужен объект с customerType: "Business". Требуется разрешение ReadCustomerData.

Документация: https://developers.tochka.com/docs/tochka-api/api/get-customers-list-open-banking-v-1-0-customers-get

GET /uapi/acquiring/v1.0/retailers — Get Retailers

Возвращает торговые точки, их статус, доступные способы оплаты и merchantId. Требуется разрешение ReadAcquiringData.

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

Параметр	Где	Тип	Обяз.	Описание
`customerCode`	query	string	да	Уникальный код клиента

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 символов

GET /uapi/acquiring/v1.0/payments/{operationId} — Get Payment Operation Info

Возвращает статус, сумму, способ оплаты и данные покупателя по одной операции. Требуется разрешение ReadAcquiringData.

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

Параметр	Где	Тип	Обяз.	Описание
`operationId`	path	string	да	Идентификатор платежа

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	нет	Статус операции

POST /uapi/acquiring/v1.0/payments/{operationId}/refund — Refund Payment Operation

Оформляет полный или частичный возврат по платежу в статусе APPROVED. Требуется разрешение MakeAcquiringOperation.

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

Параметр	Где	Тип	Обяз.	Описание
`operationId`	path	string	да	Идентификатор платежа
`Data.amount`	body	number	да	Сумма возврата: больше 0 и не больше суммы оплаты

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 символов

Нюансы

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; старые значения удаляются. Обнови ключ в интеграции и настройки вебхуков.
Песочница возвращает фиксированные ответы независимо от входных значений. Переход и реальная оплата по платёжной ссылке в ней недоступны.

Ограничения

Data.ttl платёжной ссылки принимает от 1 до 44640 минут, значение по умолчанию — 10080 минут. После перехода по ссылке у покупателя есть 1 час на оплату; при повторном переходе после истечения времени создаётся новая страница оплаты.
URL вебхука должен использовать HTTPS и порт 443. Если банк не получает HTTP 200, отправка повторяется 30 раз с интервалом 10 секунд.

Источники

Если этого недостаточно — официальная документация: https://developers.tochka.com/docs/tochka-api/ JSON: https://mcp-everything.ru/api/integrations/tochka-bank-api. MCP: https://mcp-everything.ru/mcp