O que é um gateway de pagamento cripto e como funciona

Um gateway de pagamento cripto é o serviço que fica entre a carteira do seu cliente e o seu sistema de pedidos: cria a solicitação de pagamento, observa a blockchain, avisa a sua loja quando o dinheiro chega e guarda os fundos até você sacá-los. Este guia explica como isso funciona na prática e o que verificar antes de escolher um.

O que faz um gateway de pagamento cripto

Aceitar cripto sem gateway significa dar um endereço de carteira a cada cliente, acompanhar a blockchain por conta própria, associar as transferências recebidas aos pedidos e resolver cada caso especial manualmente. Um gateway assume quatro tarefas:

Cria o pagamento. Seu sistema pede um pagamento de determinado valor; o gateway devolve uma página de pagamento ou um endereço só para aquele pedido.
Observa a rede. Vê a transferência chegar, conta as confirmações e decide quando o pagamento é definitivo.
Avisa você. Informa a sua loja, normalmente por webhook, que o pedido 1024 foi pago, para que você envie o produto ou libere o acesso.
Guarda e movimenta os fundos. O dinheiro recebido cai em um saldo de lojista, e você o saca para a sua própria carteira.

Um gateway não é uma carteira cujas chaves você controla nem uma corretora. É infraestrutura de pagamentos: a parte do pagamento com cartão que um banco e um processador costumam esconder de você, reconstruída para blockchains.

Como um pagamento percorre o gateway

Cada gateway funciona de um jeito um pouco diferente, mas o caminho de um pagamento é assim:

Seu servidor cria um pagamento: um número de pedido e um valor, normalmente em dólares.
O cliente abre a página de pagamento e escolhe um ativo e uma rede, por exemplo USDT na TRON. O lojista também pode pré-selecionar o método.
O gateway fixa a taxa de câmbio por um tempo limitado, para que o valor que o cliente deve enviar não mude enquanto paga. Na Qvard, a taxa fica fixada por uma hora.
O cliente envia o valor exato da sua própria carteira para o endereço exibido para aquele pagamento.
O gateway observa a rede, espera as confirmações e marca o pagamento como pago.
Ele notifica o seu servidor. Seu código marca o pedido como pago e libera o produto.
O dinheiro aparece no seu saldo de lojista. Você o saca para a sua carteira manualmente ou por uma regra que definir.

Pagamentos reais nem sempre saem perfeitos: clientes enviam a menos, a mais ou depois de a taxa expirar. Um bom gateway tem um status definido para cada caso, em vez de deixar a conciliação para você fazer à mão. Na Qvard, os status de um pagamento são wait, partial, completed e rejected.

Gateway, carteira, corretora e processador: qual a diferença

Esses termos costumam ser confundidos:

Carteira. Guarda chaves e permite enviar e receber. Não associa pagamentos a pedidos nem avisa a sua loja.
Corretora. Troca um ativo por outro. Algumas oferecem ferramentas para lojistas, mas a função principal é negociar.
Gateway de pagamento. Cria e acompanha pagamentos dos seus pedidos e informa o status. É o tema deste guia.
Processador ou adquirente. Nos pagamentos com cartão, a empresa que movimenta o dinheiro entre bancos. Em cripto, a palavra «adquirência» é usada de forma ampla para todo o serviço; veja adquirência cripto versus gateway de pagamento cripto para entender a diferença.

Custodial ou não custodial

A maior decisão de projeto por trás de qualquer gateway é quem guarda os fundos entre o pagamento e o seu saque.

Em um gateway custodial, os pagamentos recebidos vão para endereços controlados pelo provedor e são creditados no seu saldo de lojista. Depois você os saca. Isso simplifica a conciliação e permite recursos como saques automáticos, mas você depende do provedor até sacar, então as condições de saque importam.

Em um modelo não custodial, os pagamentos vão direto para a sua carteira. Você mantém as chaves e o provedor apenas acompanha o pagamento. Isso reduz o risco de contraparte e transfere a gestão das chaves para você.

A Qvard é custodial: os pagamentos são creditados em um saldo de lojista, e você saca para a sua carteira automaticamente por regra ou manualmente. O saque para uma carteira custa apenas a taxa de rede, e não há saque para conta bancária.

Stablecoins e redes: por que a rede importa

O mesmo ativo pode existir em várias blockchains. O USDT, por exemplo, existe na TRON (TRC-20), na Ethereum (ERC-20) e na BNB Smart Chain (BEP-20). Uma transferência só é válida na rede que a página de pagamento pediu, e taxas e velocidade variam entre as redes.

Por isso o gateway mostra o ativo e a rede juntos, e a escolha do cliente precisa ser explícita. Para o lojista, as consequências práticas são:

decida quais redes quer aceitar e confirme que o gateway as suporta;
espere que as taxas de rede dependam da blockchain e do seu congestionamento, não do gateway;
prefira stablecoins para precificar em dólares, porque um pagamento em um ativo volátil pode valer bem menos quando você sacar.

A Qvard aceita hoje USDT e USDC nas principais redes, além de BTC e LTC nativos; a TON está a caminho. A lista completa está na página de moedas e redes compatíveis.

O que verificar antes de escolher um gateway

Uma lista curta que separa um gateway utilizável de um arriscado:

Redes e ativos. Ele suporta os que seus clientes realmente usam?
Taxas. O que o gateway cobra e qual é a taxa de rede à parte? Quem paga cada uma?
Fundos e saques. Quem guarda o dinheiro, como funcionam os saques e há limites ou opções em moeda fiduciária de que você pode ou não precisar?
Qualidade da API. É possível criar um pagamento com segurança mais de uma vez com o mesmo número de pedido? Os erros são claros? O webhook é reenviado se o seu servidor estiver fora do ar?
Pagamentos atípicos. Como são tratados pagamento insuficiente, pagamento a mais e pagamentos expirados?
Testes. Dá para testar o fluxo sem movimentar dinheiro real?
Suporte e documentação. Quem responde quando um pagamento trava?

Como escolher um provedor de pagamentos cripto percorre essa lista com mais detalhe.

Como é uma integração mínima

Criar um pagamento é uma única requisição. Com a Qvard, você envia o seu próprio número de pedido e o valor em dólares americanos, e recebe um identificador de pagamento e um link para a página de pagamento hospedada. Redirecione o cliente para lá; tudo sobre escolher o ativo e enviar a transferência acontece nessa página.

O id que você envia é o seu número de pedido: enviar o mesmo id de novo para o mesmo método de pagamento devolve o pagamento existente em vez de criar um duplicado, o que torna as novas tentativas seguras. Quando o cliente paga, a Qvard envia um webhook ao seu servidor com esse mesmo id e o status do pagamento. O fluxo completo, com código para o seu backend, está em como aceitar pagamentos cripto em um site; a referência está na página para desenvolvedores.

curlPOST /api/v1/payment

curl -X POST https://api.qvard.com/api/v1/payment \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "id": "order_1024", "price": 149.99 }'

# 201 Created
{ "id": "8f3k2a1c", "redirectUrl": "https://my.qvard.com/pay/8f3k2a1c" }

Erros comuns

Confiar no redirecionamento. O cliente voltar à sua página de «obrigado» não prova que ele pagou. Marque um pedido como pago apenas quando o gateway informar um status final.
Ignorar pagamentos parciais. Se o cliente enviou menos do que o valor, o pedido não está pago. Decida com antecedência se vai pedir a diferença ou devolver o dinheiro.
Não testar a repetição do webhook. Se o seu servidor retornar erro durante um webhook, a notificação deve ser reenviada, e o seu manipulador precisa tolerar receber o mesmo evento duas vezes.
Precificar em um ativo volátil. Cote em dólares e deixe o cliente pagar com uma stablecoin se você não puder assumir o risco de preço.
Não testar o caminho do saque. Saque um valor pequeno antes de depender do gateway para receita real.

Onde a Qvard se encaixa

A Qvard é um gateway de pagamento cripto custodial para empresas. Hoje você cria um pagamento pela API, envia o cliente à página de pagamento hospedada, recebe o status final por webhook e saca do seu saldo de lojista para uma carteira. As outras formas de receber, como links de pagamento, uma janela incorporada, um SDK e um terminal de ponto de venda, estão em desenvolvimento. Você pode ver a página de pagamento real com uma fatura de demonstração antes de criar uma conta, e a página de preços explica como funcionam as taxas.

FAQ

Um gateway de pagamento cripto é a mesma coisa que uma carteira cripto?

Não. Uma carteira guarda chaves e envia transferências. Um gateway cria um pagamento para um pedido específico, acompanha-o na blockchain, informa o status à sua loja e guarda o dinheiro em um saldo de lojista até você sacar.

Um pagamento em cripto pode ser revertido?

Não. Uma transferência confirmada na blockchain é definitiva. Se precisar reembolsar um cliente, você envia uma nova transferência por conta própria, então defina a sua política de reembolso antes de começar a aceitar pagamentos.

Quanto tempo leva para um pagamento ser confirmado?

Depende da rede e de quantas confirmações o gateway espera. Algumas redes confirmam em segundos, enquanto o Bitcoin produz um bloco aproximadamente a cada dez minutos. A página de pagamento mostra o status enquanto o cliente espera.

Preciso desenvolver algo do meu lado?

Você precisa criar o pagamento a partir do seu backend e tratar o webhook que informa o status. Todo o resto, da página de pagamento ao monitoramento da blockchain, é feito pelo gateway.

O que é um gateway de pagamento cripto