O que é um gateway host-to-host de pagamentos?
O que é um gateway host-to-host de pagamentos: pagamentos servidor a servidor com redirecionamento para o checkout hospedado e webhook final, explicado.
Um gateway host-to-host de pagamentos conecta o seu servidor diretamente ao provedor de pagamentos. O seu backend cria os pagamentos, o cliente paga em uma página hospedada e o provedor devolve o resultado ao seu servidor.
O que significa host-to-host
No modelo host-to-host a requisição de pagamento vai do seu servidor ao gateway, e não do navegador. O cliente encontra o gateway apenas na página de pagamento hospedada, e as chaves e a lógica do pedido ficam do seu lado.
Como o fluxo funciona
O seu servidor cria um pagamento com POST /api/v1/payment, recebe um redirectUrl, envia o cliente para lá e recebe o status final por webhook. Três passos cobrem o fluxo inteiro.
Para quem é
Lojas online, produtos SaaS e marketplaces que já têm backend e querem controle total da lógica de checkout, dos estados dos pedidos e da conciliação.
Página hospedada e taxa fixa
O cliente paga no checkout hospedado da Qvard, que mostra o valor exato do ativo e da rede escolhidos com taxa fixa durante a validade da fatura. Você não precisa gerar endereços nem lógica de cotação.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR",
"paymentSystemId": 12
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}Segurança básica
Guarde o x-api-key no servidor, confira o cabeçalho x-api-key em cada webhook e aceite apenas endpoints HTTPS. Trate o redirecionamento como navegação, não como confirmação de pagamento.
Quando outro produto encaixa melhor
Sem backend, um link de pagamento é mais simples. Checkout incorporado, SDK, terminal e checkout no Telegram estão no roteiro; hoje o mesmo resultado vem da API e da página hospedada.
FAQ
Host-to-host é o mesmo que uma API?
É um modelo baseado em API no qual o servidor fala diretamente com o gateway. O termo descreve quem faz a chamada, o servidor, e não um protocolo diferente.
Preciso de um servidor dedicado?
Não. Qualquer backend que consiga fazer requisições HTTPS e expor uma URL de webhook basta.
Quanto custa o gateway?
A taxa base é de 1% por pagamento, as taxas individuais caem até 0,1% com o volume e as taxas de rede são pagas à parte.
Posso combinar host-to-host com a página hospedada?
Sim, esse é o fluxo padrão: a API cria o pagamento e a página hospedada o recebe.
