> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crypto-cash.world/llms.txt
> Use this file to discover all available pages before exploring further.

# Быстрый старт

## Аутентификация

Все запросы к API требуют аутентификации через подпись запроса. Каждый запрос должен содержать:

```json theme={null}
{
  {
  "data": "base64-encoded-json-string",
  "signature": "base64-encoded-signature"
  }
}
```

***

## Базовая структура запроса

* **Метод:** POST
* **Формат данных:** JSON
* **Кодировка:** UTF-8
* **Подпись:** base64( ed25519\_sign( data, PRIVATE\_KEY ) )

***

## Типы подписей

### ED25519 (Рекомендуемый)

1. Создать объект payload: `id, delivered_at, event`
2. JSON.stringify(payload)
3. Закодировать JSON-строку в Base64
4. Подписать с помощью ED25519 (ed25519.signAsync)
5. Закодировать подпись в Base64

### Legacy (Устаревший)

1. Создать объект payload: `id, delivered_at, event`
2. JSON.stringify(payload)
3. Закодировать JSON-строку в Base64
4. SHA256 хеш (privateKey + data)
5. Закодировать хеш в Base64

<Warning>
  **ВАЖНО:** При интеграции через CMS Exchanger используйте Legacy ключи
</Warning>

***

## Внешняя ссылка для получения курсов

**URL:** `https://rates.crypto-cash.world/api/v1/market/rates/export/xml`

**URL:** `https://rates.crypto-cash.world/api/v1/market/rates/export/json`

***

## Статусы транзакций в ответах API

* Queued (Очередь – В очереди на обработку)
* New (Новая - Заказ создан, ожидается депозит)
* Waiting (Ожидание - Подтверждение в блокчейне)
* Paid (Оплачено - Депозит соответствует ожидаемой сумме)
* Underpaid (Недоплата - Депозит меньше ожидаемой суммы)
* Overpaid (Переплата - Депозит превышает ожидаемую сумму)
* Canceled (Отменена - Транзакция отменена / ошибка)
* CurrencyMismatch (Несоответствие валют - Внесена неверная криптовалюта)
* CanceledButPaid / Late paid (Отменен, но оплачен - Заказ просрочен/отклонён, но получен точный депозит)
* CanceledButOverpaid / Late overpaid (Отмененный, но переплаченный - Заказ просрочен/отклонён, но получена переплата)
* CanceledButUnderpaid / Late underpaid (Отменен, но недоплачен - Заказ просрочен/отклонён, но получена недоплата)
* No credited (Сумма пополнения меньше минимальной суммы, средства не зачислены на баланс)

***

## Ошибки

При возникновении ошибок в ответ будет возвращен список из кодов ошибок.

Пример ответа с ошибкой:

```json theme={null}
{
  "errors": [1000]
}
```

#### Список ошибок:

* 1000 - Неверный запрос
* 2010 - Ошибка декодирования данных
* 2011 - Ошибка декодирования подписи
* 2020 - Неверная подпись
* 3000 - Компания не найдена
* 3001 - Заказ не найден
* 3002 - Транзакция не найдена
* 4003 - Аккаунт не активирован

***

<Card title="Crypto API" icon="pen-to-square" href="/api-reference/balance">
  Основые запросы
</Card>