# Integração H2H (White Label)

Host2Host (H2H) é um cenário de integração de API white-label no qual os detalhes de pagamento são transmitidos diretamente para o seu lado sem redirecionar o utilizador para a página de pagamento da CryptoCloud. Você controla totalmente a interface de pagamento: exibe o endereço da carteira, a rede e o montante no design do seu website ou aplicação, mantendo uma experiência de utilizador consistente com a marca.

Os estados de pagamento são entregues via notificações da API e podem ser processados automaticamente no seu sistema.

**Quando usar H2H:**

* É necessária a aceitação de pagamentos em cripto white-label sem mencionar o fornecedor de pagamentos
* Os redirecionamentos para páginas externas são proibidos
* É necessário controlo total sobre a UI/UX do pagamento
* É utilizado um checkout, aplicação ou terminal personalizado

### Como o H2H funciona

1. **Autenticação do pedido**\
   Todos os pedidos à API são assinados com as suas chaves de API das definições do projeto CryptoCloud.
2. **Criação de fatura**\
   Envia um pedido à API para [criar uma fatura](/pt/referencia-da-api-v2/create-invoice.md), especificando:

* valor da fatura
* moeda da fatura
* `criptomoeda` parâmetro — a moeda na qual o utilizador irá pagar

No H2H, especificar `criptomoeda` é obrigatório, uma vez que os dados de pagamento são gerados para a moeda selecionada.

3. **Receção dos dados de pagamento**\
   A resposta da API devolve:

* endereço de carteira único
* valor exato do pagamento

Apresenta estes dados ao utilizador na sua interface (checkout white-label).

4. **Pagamento do utilizador**\
   O utilizador transfere fundos para o endereço emitido na rede e no montante especificados.
5. **Notificação de pagamento (Postback)**\
   Após os fundos serem recebidos, a CryptoCloud envia uma notificação POST para o URL de notificação configurado nas suas [definições do projeto](https://support.cryptocloud.plus/en/getting-started/project-settings).\
   Verifica a assinatura da notificação e atualiza o estado da encomenda/serviço no seu sistema.
6. **Verificação do estado da fatura (opcional)**\
   O [estado da fatura](https://support.cryptocloud.plus/en/payments/invoice-statuses) pode ser solicitado manualmente via API usando o número INV.\
   Usado para reconciliação, novas verificações em caso de falhas na notificação ou processamento manual.

### Resultado da integração

Após ativar o H2H:

* os pagamentos ocorrem numa interface totalmente white-label
* o utilizador não sai do seu website ou aplicação
* a marca CryptoCloud não é exibida durante o pagamento
* os estados dos pagamentos são sincronizados automaticamente via API

### Importante

* o utilizador deve pagar estritamente na rede e moeda especificadas
* o montante tem de corresponder ao montante emitido pela API
* cada fatura tem um endereço único
* o endereço é válido apenas para uma fatura

### Ligação

A descrição técnica da criação de faturas, verificações de estado e tratamento de Postback está disponível na [secção Referência da API V2](https://docs.cryptocloud.plus/en/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/pt/referencia-da-api-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.