/create-payment

В отличие от /create, он позволяет указать криптовалюту и сеть сразу, а API возвращает точные адрес кошелька для отправки, без pay_url, которые клиент может оплатить мгновенно.

Вы также можете указать полезную нагрузку (payload) и URL вебхука. Все обязательные поля проходят валидацию, и платёж начинает проверку на оплату сразу после создания

Чтобы проверить, был ли оплачен платёж, вы можете:

Отправить запрос к эндпоинту /info для получения текущего статуса платежа, или
Указать URL вебхука при создании платежа и ожидать, пока API автоматически отправит обновления статуса.

HTTP Запрос

Method: POST
URL: https://api.cru.cash/v1/invoice/create-payment
Headers: Authorization: Bearer YOUR_API_KEY_HERE

Поля запроса

Поле	Название в JSON	Тип	Обязательно	Описание / Валидация
Время жизни *	`lifetime`	`int`	да	Время жизни в минутах. Минимум 3, максимум 1440.
Криптовалюта *	`crypto`	`string`	да	Криптовалюта, в которой клиент будет платить. Примеры: `TON`, `USDT`
Сеть *	`network`	`string`	да	Сеть для выбранной криптовалюты. Примеры: `TON`, `TRC20`
Валюта *	`currency`	`string`	да	Фиатная валюта, в которой указана сумма платежа. Допустимые значения: `RUB`, `USD`, `EUR`.
Сумма *	`amount`	`string`	да	Сумма платежа в фиате. Минимум: 100 RUB, 1 USD, 1 EUR. Максимум: 10,000,000.
Полезная нагрузка	`payload`	`string`	нет	Метаданные, предоставленные мерчантом. Необязательно. Длина: 5–16384 символа.
Вебхук	`webhook`	`string`	нет	URL вебхука для уведомлений. Необязательно. Поддерживает только HTTPS. Длина: 10–2048 символов.

Поля ответа

Поле	Название в JSON	Тип	Описание
ID инвойса	`invoice_id`	`string`	Уникальный ID созданного платежа.
Адрес платежа	`payment.address`	`string`	Адрес криптовалюты, на который клиент должен отправить платёж.
URL QR-кода	`payment.qr_code`	`string`	URL QR-кода
Сумма к оплате	`payment.amount_to_pay`	`string`	Сумма в криптовалюте, которую должен заплатить клиент.
Криптовалюта	`payment.crypto`	`string`	Криптовалюта, выбранная для платежа.
Сеть	`payment.network`	`string`	Сеть, используемая для выбранной криптовалюты.
Истекает	`payment.expires_at`	`int`	Unix временная метка, когда истекает срок действия этого платежа.
Тестовый режим	`test_mode`	`boolean`	Указывает, был ли платёж создан в тестовом режиме.

Примеры тела запроса и ответа

Заголовок	Значение	Описание
Authorization	Bearer `YOUR_API_KEY_HERE`	Ваш API ключ для аутентификации

Запрос #1

{
"lifetime": 30,
"amount": "100",
"currency": "USD",
"webhook": "https://test-webhook.com",
"crypto": "TON",
"network": "TON",
"payload": "{\"product\":\"vpn_pro\",\"period\":30,\"user_id\":\"u_987654\",\"note\":\"Инвойс для месячной подписки VPN\"}"
}

Ответ #1

{
  "invoice_id": "912f953a-ad8d-4b69-9d4f-0b8248b43f15",
  "payment": {
    "address": "UQCN6vbcgz-f4UVvCvfYUOe3h7pln7yTiJNCVxIgIzcoenQg",
    "qr_code": "https://api.cru.cash/v1/payment/qr-code/912f953a-ad8d-4b69-9d4f-0b8248b43f15",
    "amount_to_pay": "75.253",
    "crypto": "TON",
    "network": "TON",
    "expires_at": 1770917295
  },
  "test_mode": false
}