# H2H-интеграция (White Label)

Host2Host (H2H) — это white-label сценарий API-интеграции, при котором реквизиты для оплаты передаются напрямую на вашу сторону без переадресации пользователя на платежную страницу CryptoCloud. Вы полностью контролируете интерфейс оплаты: отображаете адрес кошелька, сеть и сумму в дизайне вашего сайта или приложения, сохраняя единый брендированный пользовательский опыт.\
Статусы платежей передаются через API-уведомления и могут автоматически обрабатываться в вашей системе.

**Когда использовать H2H:**

* требуется white-label прием криптоплатежей без упоминания платежного провайдера
* запрещены редиректы на внешние страницы
* необходим полный контроль над UI/UX оплаты
* используется собственный checkout, приложение или терминал

### Как работает H2H

**1. Авторизация запросов**

Все запросы к API подписываются вашими API-ключами из настроек проекта CryptoCloud.

**2. Создание счета**

Вы отправляете запрос на [создание инвойса](https://docs.cryptocloud.plus/ru/api-reference-v2/create-invoice) через API, указывая:

* сумму счета
* валюту счета
* параметр `cryptocurrency` — валюта, в которой пользователь будет оплачивать

В H2H обязательно указывать `cryptocurrency`, так как под выбранную валюту формируются реквизиты.

**3. Получение реквизитов**

В ответ API возвращает:

* уникальный адрес кошелька
* точную сумму к оплате

Эти данные отображаются пользователю в вашем интерфейсе (white-label checkout).

**4. Оплата пользователем**

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

**5. Уведомление о платеже (Postback)**

После поступления средств CryptoCloud отправляет POST-уведомление на URL для уведомлений, заданный в [настройках проекта](https://support.cryptocloud.plus/ru/getting-started/project-settings).

Вы проверяете подпись уведомления и обновляете статус заказа/услуги в своей системе.

**6. Проверка статуса счета (опционально)**

[Статус счета](https://support.cryptocloud.plus/ru/payments/invoice-statuses) можно запросить вручную через API по INV-номеру.\
Используется для сверки, повторной проверки при сбое уведомлений или ручной обработки.

### Результат интеграции

После подключения H2H:

* оплата проходит в полностью white-label интерфейсе
* пользователь не покидает ваш сайт или приложение
* бренд CryptoCloud не отображается в процессе оплаты
* статусы платежей автоматически синхронизируются через API

### Важно

* пользователь должен оплачивать строго в указанной сети и валюте
* сумма должна совпадать с выданной API
* каждый счет имеет уникальный адрес
* адрес действителен только для одного счета

### Подключение

Техническое описание методов создания счета, проверки статуса и обработки Postback доступно в разделе [API Reference V2](https://docs.cryptocloud.plus/ru/api-reference-v2/authorization).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cryptocloud.plus/ru/api-reference-v2/h2h.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.