Host2Host (White Label)

Integrating your project with Trybit for accepting payments without redirects.

To start integrating, you need to create a project in your Trybit dashboard and obtain an API key and Shop ID — this data is needed to configure the interaction between your system and the platform, and to authorize requests.

Host2Host (H2H) is an integration method where the customer pays an invoice without leaving the merchant's domain and interface: the Trybit brand isn't shown anywhere, and payment details are displayed directly in the project's interface, without redirecting to the Trybit payment page.

How to get payment details

1. Requests are signed with the project's API key (as with standard API integration).

2. The desired payment currency is specified when creating the invoice.

3. In response, the API returns a unique address, network, and exact amount to be paid. The merchant displays these details in its own interface — the customer transfers funds directly to them.

4. After payment, a POSTBACK notification arrives at the Notification URL; status can also be checked by invoice number (INV) via the API.

A detailed technical description of the method is available in the developer documentation.

Important details

• Payment must be made strictly on the specified network and in the specified currency, and the amount must match the one issued; otherwise the payment may not be credited automatically (see Invoice Statuses).

• The issued address is unique and valid only for that one specific invoice — a new address is issued for the next order.

• If you need to let the customer choose the payment currency themselves, rather than showing one predefined currency, either determine the currency on your side (for example, in your own checkout interface) before requesting payment details, or use the standard payment page or the HTML widget instead of Host2Host.

How It differs from standard API integration

With standard API integration, the customer is directed to a ready-made Trybit payment link/page. With Host2Host, instead of a link, the merchant receives the payment details themselves and builds the entire payment interface independently — suitable for a custom checkout, mobile apps, terminals, and cases where redirecting to a third-party domain isn't acceptable.

If you have any questions or need help, you can contact our support via chat on the website and in your personal account, as well as reach us on Telegram. Support contacts are listed on our website.