> 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/pt/referencia-da-api-v2/h2h.md).

# 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 Trybit. Você controla totalmente a interface de pagamento: exibe o endereço da carteira, a rede e o montante dentro do 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 cripto white-label sem mencionar o fornecedor de pagamento
* São proibidos redirecionamentos para páginas externas
* É necessário controlo total sobre a UI/UX de pagamento
* É utilizado um checkout, aplicação ou terminal personalizados

### Como funciona o H2H

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

* montante da fatura
* moeda da fatura
* `cryptocurrency` parâmetro — a moeda em que o utilizador irá pagar

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

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

* endereço único da carteira
* montante exato do pagamento

Você apresenta estes dados ao utilizador na sua interface (checkout white-label).

4. **Pagamento do utilizador**\
   O utilizador transfere os fundos para o endereço emitido na rede e no montante especificados.
5. **Notificação de pagamento (Postback)**\
   Depois de os fundos serem recebidos, a Trybit envia uma notificação POST para o URL de notificação configurado nas suas [definições do projeto](https://support.trybit.com/getting-started/project-settings).\
   Você 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.trybit.com/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 de notificação ou processamento manual.

### Resultado da integração

Depois de o H2H ser ativado:

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

### Importante

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

### Ligação

A descrição técnica da criação de faturas, das verificações de estado e do tratamento de Postback está disponível na [secção da Referência da API V2](/pt/referencia-da-api-v2/authorization.md).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trybit.com/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.