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

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

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

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

• требуется white-label прием криптоплатежей без упоминания платежного провайдера

• запрещены редиректы на внешние страницы

• необходим полный контроль над UI/UX оплаты

• используется собственный checkout, приложение или терминал

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

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

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

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

Вы отправляете запрос на создание инвойса через API, указывая:

• сумму счета

• валюту счета

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

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

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

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

• уникальный адрес кошелька

• точную сумму к оплате

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

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

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

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

После поступления средств CryptoCloud отправляет POST-уведомление на URL для уведомлений, заданный в настройках проекта.

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

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

Статус счета можно запросить вручную через API по INV-номеру. Используется для сверки, повторной проверки при сбое уведомлений или ручной обработки.

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

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

• оплата проходит в полностью white-label интерфейсе

• пользователь не покидает ваш сайт или приложение

• бренд CryptoCloud не отображается в процессе оплаты

• статусы платежей автоматически синхронизируются через API

Важно

• пользователь должен оплачивать строго в указанной сети и валюте

• сумма должна совпадать с выданной API

• каждый счет имеет уникальный адрес

• адрес действителен только для одного счета

Подключение

Техническое описание методов создания счета, проверки статуса и обработки Postback доступно в разделе API Reference V2.