# H2H Integration (White Label)

Host2Host (H2H) is a white-label API integration scenario in which payment details are transmitted directly to your side without redirecting the user to the CryptoCloud payment page. You fully control the payment interface: you display the wallet address, network, and amount within your website or application design, maintaining a consistent branded user experience.

Payment statuses are delivered via API notifications and can be processed automatically in your system.

**When to use H2H:**

* White-label crypto payment acceptance is required without mentioning the payment provider
* Redirects to external pages are prohibited
* Full control over the payment UI/UX is needed
* A custom checkout, application, or terminal is used

### How H2H works

1. **Request authentication**\
   All API requests are signed with your API keys from the CryptoCloud project settings.
2. **Invoice creation**\
   You send an API request to [create an invoice](https://docs.cryptocloud.plus/en/api-reference-v2/create-invoice), specifying:

* invoice amount
* invoice currency
* `cryptocurrency` parameter — the currency in which the user will pay

In H2H, specifying `cryptocurrency` is mandatory, as the payment details are generated for the selected currency.

3. **Receiving payment details**\
   The API response returns:

* unique wallet address
* exact payment amount

You display this data to the user in your interface (white-label checkout).

4. **User payment**\
   The user transfers funds to the issued address in the specified network and amount.
5. **Payment notification (Postback)**\
   After funds are received, CryptoCloud sends a POST notification to the notification URL configured in your [project settings](https://support.cryptocloud.plus/en/getting-started/project-settings).\
   You verify the notification signature and update the order/service status in your system.
6. **Invoice status check (optional)**\
   The [invoice status](https://support.cryptocloud.plus/en/payments/invoice-statuses) can be requested manually via API using the INV number.\
   Used for reconciliation, rechecks in case of notification failures, or manual processing.

### Integration result

After H2H is enabled:

* payments occur in a fully white-label interface
* the user does not leave your website or application
* the CryptoCloud brand is not shown during payment
* payment statuses are automatically synchronized via API

### Important

* the user must pay strictly in the specified network and currency
* the amount must match the API-issued amount
* each invoice has a unique address
* the address is valid for one invoice only

### Connection

The technical description of invoice creation, status checks, and Postback handling is available in the [API Reference V2 section](https://docs.cryptocloud.plus/en/api-reference-v2/authorization).