For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integração H2H (White Label)

Aprenda a ativar o Host2Host (H2H) — aceitação de pagamentos em criptomoeda em white-label sem redirecionamentos: os detalhes do pagamento são exibidos na sua interface e os status são entregues via API.

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, 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.

  1. 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).

  1. Pagamento do utilizador O utilizador transfere os fundos para o endereço emitido na rede e no montante especificados.

  2. 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. Você verifica a assinatura da notificação e atualiza o estado da encomenda/serviço no seu sistema.

  3. Verificação do estado da fatura (opcional) O estado da fatura 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.

Última atualização

Isto foi útil?