# Sber API (СберБизнес API): POST /fintech/api/v1/payments — Создание рублёвого платёжного поручения

Создаёт РПП. Если передать электронную подпись (`digestSignatures`), банк сразу начнёт обработку; без подписи поручение создаётся черновиком, который нужно подписать в интерфейсе СберБизнес. В scope должен быть сервис `PAY_DOC_RU`.

Дайджест для подписи (порядок полей сохраняется):

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `Authorization` | header | string | да | Access token организации-клиента |
| `externalId` | body | string (uuid) | да | Идентификатор документа, присвоенный партнёром |
| `date` | body | string (date) | да | Дата составления документа, YYYY-MM-DD |
| `number` | body | string | нет | Номер документа, до 8 цифр |
| `amount` | body | number | да | Сумма, от 0.01 |
| `operationCode` | body | string | да | Код операции, 01 |
| `priority` | body | string | да | Очерёдность платежа, 1–5 |
| `purpose` | body | string | да | Назначение платежа, до 210 символов |
| `payerName` | body | string | да | Полное наименование плательщика |
| `payerInn` | body | string | да | ИНН плательщика |
| `payerKpp` | body | string | нет | КПП плательщика |
| `payerAccount` | body | string | да | Счёт плательщика, 20 цифр |
| `payerBankBic` | body | string | да | БИК банка плательщика |
| `payerBankCorrAccount` | body | string | да | Корсчёт банка плательщика |
| `payeeName` | body | string | да | Полное наименование получателя |
| `payeeInn` | body | string | нет | ИНН получателя |
| `payeeKpp` | body | string | нет | КПП получателя |
| `payeeAccount` | body | string | нет | Счёт получателя |
| `payeeBankBic` | body | string | да | БИК банка получателя |
| `payeeBankCorrAccount` | body | string | нет | Корсчёт банка получателя |
| `urgencyCode` | body | string | нет | Код срочности: INTERNAL, INTERNAL_NOTIF, OFFHOURS, BESP, NORMAL |
| `deliveryKind` | body | string | нет | Вид платежа |
| `voCode` | body | string | нет | Код вида валютной операции |
| `departmentalInfo` | body | object | нет | Бюджетные реквизиты (КБК, ОКТМО, статус составителя и др.) |
| `vat` | body | object | нет | НДС |
| `incomeTypeCode` | body | string | нет | Код вида дохода по 229-ФЗ |
| `isPaidByCredit` | body | boolean | нет | Оплата за счёт кредитных средств |
| `creditContractNumber` | body | string | нет | Номер кредитного договора |
| `digestSignatures` | body | object[] | нет | Электронные подписи дайджеста документа |

Пример запроса:

```
amount=100.00
date=2018-05-31
departmentalInfo.docNumber108=123
departmentalInfo.drawerStatus101=01
departmentalInfo.kbk=18210102010011000110
departmentalInfo.oktmo=01701000
departmentalInfo.paymentKind110=НС
departmentalInfo.reasonCode106=ТП
departmentalInfo.uip=0
externalId=a0000000-0000-0000-0000-000000000001
incomeTypeCode=2
operationCode=01
payeeAccount=40702810600100001212
payeeBankBic=044525225
payeeBankCorrAccount=30101810400000000225
payeeInn=222201236445
payeeKpp=222201001
payeeName=Общество с ограниченной ответственностью "Получатель"
payerAccount=40702810500006103990
payerBankBic=044525225
payerBankCorrAccount=30101810400000000225
payerInn=222201236445
payerKpp=222201001
payerName=Общество с ограниченной ответственностью "Клиент"
priority=5
purpose=Оплата интернет заказа №123. НДС нет.
voCode=61150
creditContractNumber=2026/33556
```

## Базовые URL

- Боевой: `https://fintech.sberbank.ru:9443`
- Тестовый (песочница): `https://fintech-test.sberbank.ru:9443`
- Страница авторизации СберБизнес ID: `https://sbi.sberbank.ru:9443/ic/sso/api/v2/oauth/authorize`

## Авторизация

Тип: OAuth 2.0

Авторизация по OAuth 2.0 (authorization code flow) через СберБизнес ID. Платформа получает при подключении `client_id` и `client_secret`, перенаправляет пользователя на `/ic/sso/api/v2/oauth/authorize`, получает код на `redirect_uri` и обменивает его на `access_token`, `refresh_token` и `id_token`. Запросы к API передают токен в заголовке `Authorization`. `access_token` живёт 60 минут.

Дополнительно обязателен клиентский TLS-сертификат (mTLS) в формате PKCS#12 (.p12) и установленные корневые сертификаты УЦ Сбера и Минцифры России. Сертификат выпускается в личном кабинете Sber API (для песочницы — на вкладке «Песочница API»), действует 12 месяцев и только для одного `clientId`.

```
curl --location 'https://fintech-test.sberbank.ru:9443/fintech/api/v1/client-info' \
--header 'Accept: application/json' \
--header 'Authorization: {value}'
```

## Нюансы

- Без клиентского TLS-сертификата (mTLS) запросы к API не проходят; тестовые сертификаты работают только в песочнице, у каждого `clientId` свой сертификат.
- `access_token` живёт 60 минут. Использованный `refresh_token` остаётся резервным 2 часа; если новая пара не дошла, повторите обновление с тем же `refresh_token` в течение часа.
- Каждый метод требует своего сервиса в `scope` ссылки авторизации (например `PAY_DOC_RU`, `GET_STATEMENT_ACCOUNT`, `GET_CLIENT_ACCOUNTS`).
- Платёжное поручение без `digestSignatures` создаётся черновиком. Порядок и количество полей дайджеста для подписи менять нельзя.
- Выписку запрашивают постранично начиная с первой страницы; доступна за 5 предыдущих лет и текущий год.
- В песочнице ответы зависят от тестовых данных: сценарии и фиксированные значения указаны на странице каждого метода. Нагрузочное тестирование в песочнице не предусмотрено.
- О финальном статусе платёжного поручения банк может сообщить вебхуком — без постоянного опроса статуса.
- Для работы с дочерними организациями в наборе «Холдингам» нужна отдельная пара токенов для каждой организации.
- У Sber API есть MCP-сервер для AI-агентов (набор «Компаниям»: рублёвое платёжное поручение, выписка, инкассация, НСО и депозиты), а документация доступна в формате llms.txt: `/sber-api/llms-full.txt`.

## Сценарии с этим методом

- [Создать платёжное поручение и узнать его статус](https://mcp-everything.ru/integrations/sberbusiness/scenarios/sozdat-platezhnoe-poruchenie-i-uznat-ego.md)

---

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