> For the complete documentation index, see [llms.txt](https://docs.esimpay.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.esimpay.net/nachalo-raboty.md).

# Начало работы

#### Добро пожаловать в полную документацию API ESIMPAY — платформы для управления eSIM профилями и пакетами данных.

###  Быстрая навигация

* Быстрый старт — начните за 5 минут
* Аутентификация — как подписывать запросы
* API Reference — все endpoints
* Обработка ошибок — решение проблем

### 🌐 Базовые данные

| Параметр            | Значение                         |
| ------------------- | -------------------------------- |
| **API Endpoint**    | `https://api.esimpay.net/api/v1` |
| **API Version**     | `1.0.0`                          |
| **Authentication**  | HMAC-SHA256                      |
| **Response Format** | JSON                             |

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

#### 1. Проверьте баланс

```bash
curl -X GET https://api.esimpay.net/api/v1/customer/balance \
  -H "CF-MERCHANT-ID: your_merchant_id"
```

#### 2. Получите доступные пакеты

```bash
curl -X GET https://api.esimpay.net/api/v1/products/list \
  -H "CF-MERCHANT-ID: your_merchant_id"
```

#### 3. Создайте заказ (требуется подпись)

Смотрите раздел Аутентификация для генерирования подписи.

### Безопасность

Все запросы требуют двух заголовков:

| Заголовок        | Описание                         |
| ---------------- | -------------------------------- |
| `CF-MERCHANT-ID` | Ваш идентификатор мерчанта       |
| `CF-ACCESS-SIGN` | HMAC-SHA256 подпись тела запроса |

### Основные возможности

#### Balance Management

Отслеживайте баланс вашего счета в реальном времени.

```bash
GET /customer/balance
```

#### eSIM Orders

Создавайте заказы, пополняйте пакеты и управляйте eSIM профилями.

```bash
POST /orders/submit
POST /orders/topup
```

#### History & Reports

Получайте детальную историю всех транзакций.

```bash
GET /customer/history
```

#### Product Catalog

Просматривайте доступные пакеты и цены.

```bash
GET /products/list
```

### Статусы операций

| Статус          | Описание                      |
| --------------- | ----------------------------- |
| `completed`     | Операция успешно завершена    |
| `in_processing` | Операция находится в процессе |
| `canceled`      | Операция отменена             |
| `ERROR`         | Произошла ошибка              |