> 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/usdt/sozdat-tranzakciyu.md).

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

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

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

```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":{"CreateCryptoTransactionRequest":{"type":"object","description":"Запрос на создание крипто транзакции","required":["orderAmount","paymentCurrency"],"properties":{"merchantOrderId":{"type":"string","nullable":true,"description":"Внешний идентификатор заказа на стороне мерчанта (опционально)"},"callbackUrl":{"type":"string","format":"uri","nullable":true,"description":"URL для получения вебхуков об изменении статуса платежа"},"orderAmount":{"$ref":"#/components/schemas/MoneyDto","description":"Сумма заказа"},"paymentCurrency":{"type":"string","description":"Токен для оплаты"}}},"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}$"}}},"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":"Максимально допустимая сумма"}}}},"responses":{"Unauthorized":{"description":"Ошибка авторизации — неверные или отсутствующие заголовки аутентификации"},"Forbidden":{"description":"Доступ запрещён — недостаточно прав для выполнения операции"},"InternalServerError":{"description":"Внутренняя ошибка сервера"}}},"paths":{"/api/v1/transactions/crypto":{"post":{"tags":["Крипта"],"summary":"Создание новой крипто транзакции","description":"Создаёт транзакцию для крипто оплаты и возвращает идентификатор для отслеживания.","operationId":"createCryptoTransaction","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/CreateCryptoTransactionRequest"}}}},"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"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/InternalServerError"}}}}}}
```