Точка Банк API: Принять оплату по платёжной ссылке

Сценарий из mcp-everything. Актуально на 2026-10-13.

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

  1. Подключи интернет-эквайринг и получи токен с разрешениями MakeAcquiringOperation, ReadAcquiringData и ReadCustomerData.
  2. Запроси GET /uapi/open-banking/v1.0/customers и возьми customerCode из объекта с customerType: "Business".
  3. Если торговых точек несколько, запроси GET /uapi/acquiring/v1.0/retailers с customerCode и выбери merchantId точки с status: "REG" и isActive: true.
  4. Создай ссылку: POST /uapi/acquiring/v1.0/payments.
  5. Перенаправь покупателя по Data.paymentLink и сохрани Data.operationId.
  6. Дождись вебхука 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"
      ]
    }
  }'

Базовые URL

Авторизация

Тип: 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/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 да Идентификатор платежа

Нюансы

Другие сценарии

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