# Точка Банк API: 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<date> | да | Дата платежа по ISO 8601, приведённая к часовому поясу Москвы |
| `Data.paymentPurpose` | body | string | да | Назначение платежа, не более 210 символов |
| `Data.payerINN` | body | string | нет | Обязательно при платеже за третье лицо |
| `Data.payerKPP` | body | string | нет | Обязательно в указанных документацией бюджетных платежах и платежах за нерезидента |
| `Data.paymentPriority` | body | string | нет | Очерёдность платежа; значение по умолчанию — 5 |

## Базовые 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://mcp-everything.ru/integrations/tochka-bank-api/scenarios/podgotovit-i-otpravit-ishodyaschiy.md)

---

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