> For the complete documentation index, see [llms.txt](https://developers.friendlypay.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.friendlypay.io/transactions/sbp/sozdat-tranzakciyu.md).

# Создать транзакцию

## Создание новой SBP транзакции

> Создаёт транзакцию для оплаты через СБП и возвращает идентификатор для отслеживания.

```json
{"openapi":"3.0.3","info":{"title":"FriendlyPay API","version":"1.0.0"},"tags":[{"name":"СБП","description":"Транзакции через Систему быстрых платежей (СБП)"}],"servers":[{"url":"https://pay.friendlypay.io","description":"Production API server (эндпоинты доступны по префиксу /api)"}],"security":[{"FpTimestamp":[],"FpNonce":[],"FpApiToken":[],"FpSignature":[]}],"components":{"securitySchemes":{"FpTimestamp":{"type":"apiKey","in":"header","name":"x-fp-timestamp","description":"Unix timestamp запроса (целое число, минимум 1)"}},"parameters":{"XFpTimestamp":{"name":"x-fp-timestamp","in":"header","required":true,"description":"Временная метка Unix.","schema":{"type":"integer","format":"int64","minimum":1}},"XFpNonce":{"name":"x-fp-nonce","in":"header","required":true,"description":"Уникальная строка.","schema":{"type":"string"}},"XFpApiToken":{"name":"x-fp-api-token","in":"header","required":true,"description":"Публичный api токен мерчанта.","schema":{"type":"string"}},"XFpSignature":{"name":"x-fp-signature","in":"header","required":true,"description":"HMAC-SHA256 подпись. Алгоритм формирования см. в разделе «Аутентификация».","schema":{"type":"string"}}},"schemas":{"CreateSbpTransactionRequest":{"type":"object","description":"Запрос на создание SBP транзакции","required":["orderAmount","cart"],"properties":{"merchantOrderId":{"type":"string","nullable":true,"description":"Внешний идентификатор заказа на стороне мерчанта (опционально)"},"callbackUrl":{"type":"string","format":"uri","nullable":true,"description":"URL для получения вебхуков об изменении статуса платежа"},"orderAmount":{"$ref":"#/components/schemas/MoneyDto","description":"Сумма заказа"},"cart":{"type":"array","description":"Состав заказа (корзина товаров). Передаётся обязательно по требованию банка-эквайера: корзина не может быть пустой. Сумма позиций должна соответствовать orderAmount.","minItems":1,"items":{"$ref":"#/components/schemas/CartItem"}}}},"MoneyDto":{"type":"object","description":"Денежная сумма с валютой","required":["value","currency"],"properties":{"value":{"type":"number","format":"decimal","description":"Сумма денег","exclusiveMinimum":true,"minimum":0},"currency":{"type":"string","description":"Код валюты по ISO 4217","pattern":"^[A-Z]{3}$"}}},"CartItem":{"type":"object","description":"Позиция в корзине заказа","required":["name","price","currency","quantity"],"properties":{"name":{"type":"string","maxLength":256,"description":"Название товара. Не пустое, до 256 символов, без управляющих символов (код < 0x20)."},"price":{"type":"number","format":"double","exclusiveMinimum":true,"minimum":0,"description":"Цена за единицу товара. Должна быть больше 0."},"currency":{"type":"string","minLength":3,"maxLength":10,"pattern":"^[A-Z]{3,10}$","description":"Валюта позиции (только заглавные буквы A-Z, 3–10 символов)."},"quantity":{"type":"integer","format":"int32","exclusiveMinimum":true,"minimum":0,"description":"Количество единиц товара. Должно быть больше 0."}}},"CreateTransactionResponse":{"type":"object","description":"Ответ на успешное создание транзакции","required":["transactionId"],"properties":{"transactionId":{"type":"string","format":"uuid","description":"Идентификатор созданной транзакции в системе FriendlyPay"}}},"LimitMinAmountError":{"type":"object","description":"Ошибка — сумма заказа ниже минимально допустимой","required":["error","minAmount"],"properties":{"error":{"type":"string","enum":["LimitMinAmount"],"description":"Тип ошибки"},"minAmount":{"$ref":"#/components/schemas/MoneyDto","description":"Минимально допустимая сумма"}}},"LimitMaxAmountError":{"type":"object","description":"Ошибка — сумма заказа выше максимально допустимой","required":["error","maxAmount"],"properties":{"error":{"type":"string","enum":["LimitMaxAmount"],"description":"Тип ошибки"},"maxAmount":{"$ref":"#/components/schemas/MoneyDto","description":"Максимально допустимая сумма"}}},"CartValidationError":{"type":"object","description":"Ошибка валидации корзины (cart) при создании платежа","required":["error","reason"],"properties":{"error":{"type":"string","enum":["Cart"],"description":"Тип ошибки"},"reason":{"type":"string","enum":["CartRequired","CartItemNameInvalid","CartItemPriceInvalid","CartItemCurrencyInvalid","CartItemQuantityInvalid"],"description":"Причина ошибки. `CartRequired` — корзина не передана или пуста; остальные — невалидное поле конкретной позиции."},"itemIndex":{"type":"integer","format":"int32","nullable":true,"description":"Индекс невалидной позиции в массиве cart. `null`, если ошибка относится к корзине в целом (например, CartRequired)."}}}},"responses":{"Unauthorized":{"description":"Ошибка авторизации — неверные или отсутствующие заголовки аутентификации"},"Forbidden":{"description":"Доступ запрещён — недостаточно прав для выполнения операции"},"InternalServerError":{"description":"Внутренняя ошибка сервера"}}},"paths":{"/api/v1/transactions/sbp":{"post":{"tags":["СБП"],"summary":"Создание новой SBP транзакции","description":"Создаёт транзакцию для оплаты через СБП и возвращает идентификатор для отслеживания.","operationId":"createSbpTransaction","parameters":[{"$ref":"#/components/parameters/XFpTimestamp"},{"$ref":"#/components/parameters/XFpNonce"},{"$ref":"#/components/parameters/XFpApiToken"},{"$ref":"#/components/parameters/XFpSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSbpTransactionRequest"}}}},"responses":{"200":{"description":"Транзакция успешно создана","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTransactionResponse"}}}},"400":{"description":"Неверные параметры запроса (нарушение лимитов суммы или ошибка валидации корзины)","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/LimitMinAmountError"},{"$ref":"#/components/schemas/LimitMaxAmountError"},{"$ref":"#/components/schemas/CartValidationError"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```