> ## 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="/ua-api-reference/balance">
  Основні запити
</Card>