> For the complete documentation index, see [llms.txt](https://docs.trybit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trybit.com/ru/api-reference-v2/h2h.md). # H2H-интеграция (White Label) Создание счета для Host2Host-интеграции: параметры запроса, ответ и отображение реквизитов в вашем интерфейсе. **Host2Host (H2H)** — способ интеграции, при котором реквизиты для оплаты возвращаются в ответе API, а покупатель оплачивает счет в вашем интерфейсе без перехода на платежную страницу Trybit. Он подходит для собственного чекаута, мобильных приложений и терминалов. Подробнее о сценарии — на странице [Host2Host (White Label)](https://support.trybit.com/ru/integration/h2h) в базе знаний. ### Какие поля ответа нужны для собственного чекаута | **Поле** | **Что показать покупателю** | | ------------------------------------------------ | --------------------------------------------------------- | | address | Адрес для перевода | | amount | Точная сумма к оплате в криптовалюте | | currency.code, currency.name | Криптовалюта оплаты | | currency.network.code, currency.network.fullname | Сеть перевода | | expiry\_date | Срок действия счета — для таймера. Время указано по UTC+0 | | uuid | Номер счета (INV) | | amount\_in\_fiat, fiat\_currency | Сумма счета в фиатной валюте | | MEMO / Comment | MEMO / Comment — для сети TON | ### Что обязательно показать покупателю * Адрес и сеть перевода. * Точную сумму в криптовалюте. * MEMO / Comment — для сети TON. * Таймер до окончания срока действия счета. * QR-код с адресом. * Предупреждение: комиссию сети, кошелька или биржи отправитель оплачивает сверх суммы счета. Если поступит меньше, счет получит статус «Частично оплачен». ### MEMO / Comment MEMO / Comment обязателен для платежей в сети TON. Без него система не определит платеж, и он не будет зачислен автоматически — такую оплату можно зачислить по счету только вручную через поддержку. Для счетов в сети TON показывайте MEMO / Comment рядом с адресом и предупреждайте покупателя, что его нужно указать при переводе. ### Недоплата, переплата и доплата * **Недоплата.** Если поступило меньше суммы счета, счет получает статус partial («Частично оплачен»). До окончания срока действия покупатель может доплатить разницу на тот же адрес. Покажите в интерфейсе оставшуюся сумму. Вы также можете подтвердить счет вручную в разделе «Платежи» или настроить автоподтверждение при небольшом отклонении в разделе «Комиссии». * **Переплата.** Счет получает статус overpaid («Переплата») и засчитывается в полном объеме. ### Что происходит при истечении срока счета Если оплата не поступила до expiry\_date, счет переходит в статус canceled. Оплата по истекшему счету автоматически не зачисляется — для зачисления нужно обратиться в поддержку с номером INV и TXID. Чтобы покупатель мог оплатить заказ, создайте новый счет — для него будет выдан новый адрес. ### Повторная оплата на тот же адрес Адрес действителен только для одного счета. Повторный перевод на адрес уже оплаченного счета автоматически не зачисляется — только через поддержку. Если покупатели должны платить на один постоянный адрес, используйте [статические кошельки](/ru/api-reference-v2/static-wallet.md). ### Как обработать POSTBACK * После оплаты Trybit отправляет POST-запрос на URL для уведомлений проекта — только на порты 443 и 80. * Параметр token — JWT-токен, подписанный SECRET KEY проекта по алгоритму HS256. Токен действителен 5 минут с момента отправки, поэтому время на сервере должно быть синхронизировано. * Обрабатывайте каждый счет один раз: при повторном уведомлении по тому же invoice\_id не выдавайте товар заново. * Если уведомление не пришло, сверьте статус запросом [Информация о счете](/ru/api-reference-v2/invoice-information.md) по номеру INV. Параметры уведомления и примеры обработчиков — на странице [Автоматический POSTBACK](/ru/api-reference-v2/postback.md). ### Как протестировать H2H 1. В тестовом режиме создайте счет с параметром cryptocurrency — так же, как это будет происходить при заказе покупателя. 2. Проверьте, что реквизиты корректно отображаются в вашем интерфейсе. 3. В разделе «Платежи» переключитесь на «Тестовые», откройте счет и нажмите «Подтвердить счет без оплаты». 4. Убедитесь, что POSTBACK доставлен и статус заказа обновился. Подробнее — на странице [Тестирование интеграции](/ru/start/test-integration.md). ### Доступ и ограничения * H2H доступен всем проектам без отдельного подключения — достаточно передать параметр cryptocurrency при создании счета. Валюты, сети, лимиты и требования к проекту те же, что и для остальных способов интеграции. * Минимальные суммы по валютам — на странице [Валюты, сети и лимиты](https://support.trybit.com/ru/general-information/currencies-networks). * Криптовалюта из параметра cryptocurrency должна быть включена в разделе «Валюты проекта». ### Схема последовательности запросов Платформа клиента → API Trybit (создание счета с cryptocurrency) → реквизиты в интерфейсе платформы → покупатель → блокчейн → POSTBACK на URL для уведомлений → проверка статуса по INV. {% hint style="success" %} Если у вас возникли вопросы или требуется помощь, вы можете обратиться в наш чат поддержки на сайте и в личном кабинете, а также связаться с нами в Telegram. Контакты поддержки указаны [на нашем сайте](https://trybit.com/support). {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.trybit.com/ru/api-reference-v2/h2h.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.