Um guia pré-lançamento e uma análise passo a passo em vídeo
Pergunta {{n}} de {{t}}
Pronto para entrar ao vivo
Sua equipe tem respostas para as perguntas-chave. Você está perto do lançamento: execute seus testes com pagamentos reais antes de entrar ao vivo.
Quase lá
Algumas lacunas permanecem. Feche-as antes do lançamento: cada uma é abordada em uma seção deste artigo.
Ainda não está pronto
Várias decisões-chave ainda estão em aberto. O Hosted Checkout tira a maior parte do trabalho da sua equipe, e você pode solicitar uma demonstração ao vivo da equipe de vendas da Volet.com para ver o fluxo de pagamento primeiro.
Lista de verificação pré-lançamento da API
Nove perguntas a serem respondidas antes de você entrar ao vivo. Escolha a resposta que se encaixa na sua equipe: cada resposta abre uma nota curta e aponta para a parte deste artigo que a explica.
Pergunta 1 de 9
1. O produto requer uma interface de pagamento personalizada?
Sim, precisamos da nossa própria UI
Não, uma página hospedada funciona
Ainda não decidido
Se sim, você precisa apenas da API, e sua equipe constrói e mantém as telas de pagamento. Se não, o Hosted Checkout é o caminho de menor esforço, e ele também aceita pagamentos de saldos de conta da Volet.com.
→ Veja: API ou Hosted Checkout: uma comparação prática, abaixo
2. Devemos controlar cada etapa do funil de pagamento, ou um redirecionamento é aceitável?
Devemos controlar cada etapa
Um redirecionamento está bom
Ainda não decidido
Com um redirecionamento para o Hosted Checkout, a Volet.com envia notificações de status para sua URL de Status. Com sua própria UI de pagamento na API, seu backend precisa verificar o status do pagamento por conta própria.
→ Veja: API ou Hosted Checkout: uma comparação prática, abaixo
3. Temos capacidade para construir e manter a interface de pagamento, o manuseio de expiração e as verificações de status?
Sim, temos a capacidade
Não, o Hosted Checkout se encaixa melhor para nós
Ainda não tenho certeza
Apenas API significa que sua equipe possui as telas de pagamento, a expiração da fatura (uma taxa de fatura é válida por 60 ou 15 minutos) e verificações de status regulares.
→ Veja: O que sua equipe realmente precisa construir, abaixo
4. Definimos como os pedidos internos se mapeiam para as tentativas de pagamento e como a duplicação de cumprimento será evitada?
Sim, está definido
Ainda não
Mantenha cada pedido separado de suas tentativas de pagamento, use um orderId exclusivo para cada tentativa e cumpra cada pedido apenas uma vez.
→ Veja: Modelo de pedido e pagamento do backend, abaixo
5. Decidimos como reconciliar transações de provedores, valores recebidos, taxas e moeda de liquidação?
Sim, temos um processo
Ainda não
Armazene o ID da transação da Volet.com, o valor recebido e a moeda de liquidação com cada pedido, para que cada pagamento corresponda a uma fatura.
→ Veja: Modelo de pedido e pagamento do backend, abaixo
6. Orçamos para cenários de falha, QA de ponta a ponta e monitoramento de produção?
Sim, está no plano
Ainda não
Estime o caminho feliz e os caminhos de falha separadamente: timeouts, faturas expiradas e tentativas repetidas levam tempo real de engenharia.
→ Veja: Estime o trabalho realisticamente, abaixo
7. Decidimos como lidar com subpagamentos, sobrepagamentos, pagamentos atrasados e pagamentos em rede errada?
Sim, nossas regras estão definidas
Ainda não
As configurações do gateway decidem se subpagamentos e sobrepagamentos são aceitos. Pagamentos enviados pela rede errada podem ser perdidos. Escreva suas regras e política de reembolso em seus termos de venda.
→ Veja: Como os pagamentos em cripto diferem dos pagamentos com cartão, abaixo
8. As finanças sabem em qual moeda os pagamentos são liquidadas e como a conversão é precificada?
Sim, as finanças sabem
Ainda não
Você pode manter a cripto que recebe ou convertê-la automaticamente. USD, USDT e USDC se convertem a uma taxa fixa de 1:1; outras conversões custam extra.
→ Veja: O que custa com a Volet.com, abaixo
9. Planejamos como testar com pagamentos reais, dado que não há sandbox?
Sim, temos um plano de teste
Ainda não
A Volet.com não tem sandbox. Solicite uma demonstração ao vivo, crie o gateway cedo e teste com pagamentos reais antes do lançamento.
→ Veja: Testando sem um sandbox, abaixo
Seu resultado
Responda todas as nove perguntas para ver seu resultado.
Ainda aberto:
Como os pagamentos em criptomoedas diferem dos pagamentos com cartão
Se sua equipe já integrou pagamentos com cartão antes, alguns hábitos não serão mantidos. Com cartões, o comerciante cobra do cliente. Com criptomoedas, o cliente envia fundos de sua própria carteira, e seu sistema deve reagir ao que realmente chega. Isso muda o que a integração deve lidar.
O valor pode diferir da fatura. Um cliente pode enviar um pouco menos ou mais do que o solicitado, por exemplo, devido a taxas de rede ou diferenças de taxa de câmbio. Decida com antecedência se aceitará subpagamentos e sobrepagamentos.
Por exemplo, você pode aceitar pequenas diferenças, entrar em contato com o cliente ou emitir um reembolso. O que quer que você decida, declare em seus termos de venda, juntamente com suas regras de reembolso e quem paga a taxa de rede em um reembolso.
A rede importa. O mesmo token existe em várias blockchains. Fundos enviados pela rede errada ou para o endereço errado podem ser perdidos.
A cotação expira. Uma taxa de fatura é válida por 60 minutos se você liquidar na mesma moeda e por 15 minutos se a conversão for necessária. Um cliente que paga atrasado pode precisar de um novo pedido de pagamento.
A confirmação leva tempo. Os fundos são creditados somente após a blockchain confirmar o pagamento, então sua interface e lógica de pedidos devem lidar com a espera.
Não há estornos e não há reversões automáticas. Uma transação confirmada na blockchain não pode ser cancelada. Um reembolso é um pagamento separado de acordo com sua própria política e as regras de proteção ao consumidor aplicáveis.
A liquidação é uma decisão comercial. Os fundos são creditados na sua conta Volet.com assim que o pagamento é concluído. Você pode manter a criptomoeda que recebeu ou convertê-la automaticamente em stablecoins ou fiat, para que as finanças possam reconciliar em uma moeda e evitar volatilidade.
Confirmações de rede gerenciadas para você. A Volet.com monitora a blockchain, aguarda as confirmações necessárias e credita os fundos, para que seu backend não precise rastrear blocos ou contagens de confirmação.
Um saldo de stablecoin em várias redes. Uma stablecoin recebida em uma rede pode ser retirada através de outra rede suportada sem a necessidade de um serviço de ponte cross-chain separado.
Sem reserva rotativa. A Volet.com não retém parte dos seus pagamentos concluídos como uma reserva rotativa.
Suas regras para subpagamento e sobrepagamento. Nas configurações do gateway, você decide se aceita pagamentos que estão abaixo ou acima do valor da fatura. Por exemplo, se os clientes recarregarem um saldo com você, você pode creditar exatamente o que chegou e aceitar subpagamentos. Com um sobrepagamento, apenas o valor do pedido é creditado na sua conta.
Pagamentos atrasados tratados. Se um pagamento chegar após a expiração da fatura, a Volet.com ou o devolve ao cliente ou, em alguns casos, credita na sua conta.
Dinheiro entrando, dinheiro saindo. O mesmo saldo da Volet.com pode financiar seus pagamentos de saída: pagamentos em massa para contratados, criadores ou parceiros, ou retiradas para seus próprios usuários. Por exemplo, uma exchange pode aceitar depósitos de cripto dos usuários e processar suas retiradas de cripto do mesmo saldo da Volet.com através da API.
A Volet.com ajuda a construir os seus pagamentos globais
Em moeda fiduciária, cripto e stablecoins. Via API, Hosted Checkout ou plugins fáceis de instalar. Aceite, envie e administre fundos — tudo a partir do código.
A decisão chave é quanta da experiência de pagamento seu produto precisa controlar — e quanta esforço de engenharia você está preparado para investir nisso.
Escolha apenas API quando você precisar de sua própria interface de pagamento e controle sobre todo o funil de pagamento. Seu aplicativo possui cada etapa voltada para o cliente, desde mostrar as instruções de pagamento até manter o cliente informado até que o pagamento seja confirmado ou expire. Sua equipe constrói e mantém tudo isso.
Escolha o Checkout Hospedado quando uma interface de pagamento personalizada e controle total sobre cada etapa não forem requisitos. O Volet.com hospeda a página de pagamento, tornando este geralmente o caminho mais simples e de menor esforço. Também funciona dentro de bots do Telegram e mini apps, onde a página de pagamento é aberta em uma janela de navegador dentro do aplicativo (webview).
Veja como pode ser o Checkout Hospedado do Volet.com
Você também pode combinar o Checkout Hospedado com a API para consulta de pedidos e reconciliação. De qualquer forma, o Checkout Hospedado ainda precisa de trabalho no backend. Seu aplicativo mantém seus próprios registros de pedidos e os combina com o status de pagamento do lado do Volet.com. Seu backend também assina as solicitações que envia para o Checkout Hospedado, o que ajuda a proteger contra solicitações adulteradas que poderiam redirecionar o pagamento de um cliente para fora da sua loja.
Fator de decisão
Somente API
Checkout Hospedado
Interface de pagamento voltada para o cliente
Construído e mantido pela sua equipe
Hospedado pelo Volet.com
Controle sobre o funil de pagamento
Alto: seu aplicativo possui a experiência
Mais limitado: o cliente segue o fluxo hospedado
Esforço de engenharia
Maior: UI, verificações de status, expiração e casos extremos
Menor para a UI de pagamento; o backend ainda assina solicitações de pagamento, lida com notificações e atualiza pedidos
Melhor ajuste
Checkout personalizado em um site ou em um aplicativo, bot ou plataforma
Um fluxo de pagamento padrão onde redirecionar para uma página hospedada é aceitável, incluindo bots do Telegram e mini apps
Tratamento de status
Backend verifica o status do pagamento através da API
Notificações de URL de status mais consulta à API para reconciliação conforme necessário
Pagamento de um saldo de conta Volet.com
Não disponível: somente API aceita cripto de carteiras externas
Disponível: os clientes podem pagar a partir do saldo de sua conta Volet.com, taxa de 0,25%
A Volet.com ajuda a construir os seus pagamentos globais
Em moeda fiduciária, cripto e stablecoins. Via API, Hosted Checkout ou plugins fáceis de instalar. Aceite, envie e administre fundos — tudo a partir do código.
Os endpoints de fatura são apenas uma parte de uma implementação apenas com API. Antes de se comprometer com isso, considere as responsabilidades do produto e operacionais abaixo.
Como o fluxo funciona com apenas API:
Crie o pedido em seu próprio sistema.
Crie uma fatura em cripto através da API.
Mostre ao cliente o endereço, valor, moeda, rede e tempo de expiração retornados pela API.
O cliente envia o pagamento de sua carteira.
Seu backend verifica o status do pagamento através da API.
Uma vez que o pagamento é confirmado, marque o pedido como pago e o cumpra.
Como o fluxo funciona com Checkout Hospedado e a API:
Crie o pedido em seu sistema e redirecione o cliente para o Checkout Hospedado com seu orderId.
O cliente paga na página do Checkout Hospedado.
Volet.com envia uma notificação para sua URL de Status, o endpoint em seu servidor que recebe atualizações de pagamento.
Seu backend verifica a assinatura e, se necessário, confirma o pedido através da API.
Marque o pedido como pago e o cumpra.
Interface de pagamento e ciclo de vida da fatura. Seu aplicativo deve exibir os detalhes do pagamento retornados pela API com precisão: valor a enviar, moeda, rede blockchain, endereço, qualquer tag de destino ou memo, e tempo de expiração. Deve alertar os clientes para enviar fundos apenas pela rede especificada. Instruções de pagamento incorretas podem resultar na perda de fundos, portanto, este é um requisito funcional, não um detalhe visual.
Não diga ao cliente que um pagamento falhou ou foi concluído antes que o status do pagamento o confirme.
Modelo de pedido e pagamento do backend. Mantenha seu pedido interno separado de uma tentativa de pagamento ou fatura. Isso facilita o manuseio de checkouts abandonados, faturas expiradas, um cliente tentando novamente e atualizações de status que chegam após o usuário ter deixado a página.
Use um único orderId para cada tentativa de pagamento, conforme descrito na documentação da API. Defina em seu próprio banco de dados como cada tentativa se mapeia para o pedido. Armazene o ID da transação Volet.com, o valor recebido e a moeda de liquidação com cada pedido, para que as finanças possam corresponder cada pagamento a uma fatura sem planilhas manuais. O tratamento fiscal dos recibos de cripto depende da sua jurisdição, então concorde com seu contador.
Escolha o modelo de valor da fatura. Decida se o pedido é precificado na moeda que você espera receber ou se o cliente deve enviar um valor fixo de uma criptomoeda específica. Essa escolha afeta a exibição de preços, a reconciliação e como você explica o valor devido. Alinhe isso com seu modelo de precificação e contabilidade, e valide os valores calculados antes de criar faturas ao vivo. A documentação da API explica como configurar cada opção.
Suponha que seu cliente faça um pedido de €120 e pague em cripto. Seu backend deve reter informações suficientes para corresponder o pagamento concluído ao pedido original. Para este pagamento, ele armazenaria:
Seu ID de pedido (ORD-10482) identifica a compra em seu sistema.
O ID da transação Volet.com (VLT-839201) vincula o pagamento à transação do lado da Volet.com.
O valor recebido (cerca de 139 USDT) mostra o que o cliente realmente enviou.
A moeda de liquidação (EUR) registra a moeda na qual sua equipe financeira contabiliza.
O status do pagamento (final, confirmado pela API) informa se o pagamento pode ser considerado completo.
Para reconciliar, vincule a transação Volet.com à sua tentativa de pagamento e ao pedido, em seguida, compare o ID da transação, os valores esperados e recebidos, a moeda e o status final do pagamento. Se um pagamento estiver faltando, atrasado ou não corresponder ao valor esperado, sinalize-o para investigação em vez de marcar automaticamente o pedido como pago.
Um cliente cria um pedido, abre a página de pagamento e envia a criptomoeda necessária. Antes que a blockchain confirme a transação, ele fecha a aba do navegador e sai do seu site.
Seu backend continua monitorando o pagamento:
O pedido do cliente permanece pendente em seu sistema.
A tentativa de pagamento continua de forma independente. Com apenas a API, seu backend verifica seu status através da API. Com o Checkout Hospedado, a Volet.com envia uma notificação para sua URL de Status.
Seu backend verifica o status do pagamento através da API.
Uma vez que o pagamento é confirmado como completo, seu sistema marca o pedido como pago e aciona a execução.
Se o cliente retornar ao seu site, ele verá o status do pedido atualizado.
O ponto importante: fechar a página de checkout não cancela o pagamento nem o confirma. Seu backend, e não o redirecionamento do navegador, determina quando o pedido pode ser cumprido.
Tratamento de status e recuperação. Com apenas API, sua equipe precisa escolher uma estratégia de polling (com que frequência o backend verifica o status), evitar solicitações desnecessárias e lidar com falhas temporárias de busca sem alterar incorretamente o estado do pedido.
Trate uma notificação como um sinal, não como prova de pagamento: verifique sua assinatura e busque o pedido através da API antes de cumpri-lo. Processe cada pedido uma vez, identificado pelo seu próprio orderId, para que uma notificação repetida ou uma segunda verificação de status não possam cumpri-lo duas vezes.
Cumprir um pedido somente após a API confirmar que o pagamento está completo, não quando a criação da fatura for bem-sucedida ou o navegador redirecionar. Os valores exatos de status e como lidar com cada um estão descritos na documentação da API.
A request can time out even when the remote system has processed it. Do not blindly retry invoice creation after an ambiguous failure. Before deciding what to do next, log the API's errorId, check the existing order and payment state, and follow the documented error handling. Never create a duplicate order automatically, and retry a request only when it is safe to do so.
Segurança e prontidão operacional. Mantenha segredos da API e credenciais de autenticação no servidor. Nunca os exponha em código de frontend, aplicativos móveis, bots ou scripts do lado do cliente. Configure apenas as permissões necessárias para a integração e restrinja o acesso à API aos endereços IP dos seus servidores: permitir todos os IPs não é recomendado em produção.
Projetando um fluxo de pagamento confiável
Um fluxo de pagamento deve lidar com mais do que o caso de sucesso.
Decida o que o produto deve fazer quando:
a criação da fatura expira e o resultado é desconhecido;
uma busca de status falha temporariamente;
uma fatura expira antes que o cliente pague;
o cliente abandona o checkout e retorna mais tarde;
o cliente inicia outra tentativa de pagamento;
uma notificação de status é atrasada ou recebida mais de uma vez.
O objetivo é evitar o cumprimento duplicado, manter o estado do pedido interno consistente e dar ao cliente um próximo passo claro.
A Volet.com não possui um sandbox ou ambiente de teste. Planeje isso cedo em vez de descobrir no lançamento:
Solicite uma demonstração ao vivo da equipe de vendas da Volet.com para ver o fluxo de pagamento, a API e o Checkout Hospedado antes de você construir.
Crie o gateway cedo. Um novo gateway custodial (aquele onde a Volet.com mantém os fundos recebidos na sua conta) passa por uma revisão de conformidade que geralmente leva algumas horas, e você pode terminar a integração nesse meio tempo.
Teste com pagamentos reais em produção: sucesso, falha, expiração, subpagamento e sobrepagamento. Cada pagamento de teste em cripto é uma transação real na blockchain com uma taxa de rede.
Para o Checkout Hospedado, verifique também a entrega da URL de Status, validação de assinatura e os redirecionamentos de sucesso e falha.
Marque os pedidos de teste em seu banco de dados para que não se misturem com a receita real durante a reconciliação.
Estimando o trabalho realisticamente
O esforço real depende da arquitetura de checkout existente, da experiência do usuário necessária, da experiência dos seus engenheiros com APIs de pagamento e do escopo de testes (QA).
Fluxo de trabalho
Somente API
Checkout Hospedado
Configuração de conta e gateway
Verificação de conta, configuração da API, permissões e aprovação
Verificação de conta, configuração do Checkout Hospedado e qualquer aprovação necessária
Implementação principal
Criação de fatura, UI de pagamento, verificações de status e atualizações de pedidos
Fluxo de redirecionamento, manipulação da URL de Status e atualizações de pedidos no backend
Casos extremos
Expiração, timeouts ambíguos, tentativas de repetição, tentativas duplicadas e instruções de rede
Validação de notificações, casos extremos de redirecionamento e reconciliação
QA
Exibição de detalhes de pagamento, verificações de status, expiração, falhas e recuperação
Redirecionamentos, entrega de notificações, validação de assinatura e reconciliação
Propriedade contínua
Manutenção de UI, monitoramento, diagnósticos de suporte e gerenciamento de status
Monitoramento de backend, reconciliação de pedidos e operações de callback
Estime o caminho de sucesso e os caminhos de falha separadamente, e inclua tempo para testes de ponta a ponta e monitoramento de produção.
Quanto custa com a Volet.com
A partir de 0,25% para pagamentos em stablecoin e criptomoedas. As conversões entre USD, USDT e USDC ocorrem a uma taxa fixa de 1:1; outras conversões são precificadas separadamente. O cliente paga a taxa da rede blockchain. Sem taxa de configuração e sem taxa mensal. Você escolhe quem paga a taxa de processamento. Altos volumes podem se qualificar para preços personalizados através das vendas.
Aceite USDT, USDC e os principais tokens cripto em todo o mundo
Comece com o gateway de pagamentos cripto — liquidações instantâneas e taxas desde 0,25%
Não. A Volet.com não possui ambiente de teste. Você pode solicitar uma demonstração ao vivo da equipe de vendas. Teste sucesso, falha, expiração, pagamento a menos e pagamento a mais do seu lado antes do lançamento.
Novos gateways de custódia passam primeiro por uma revisão de conformidade. Geralmente leva algumas horas. Sua conta deve ser verificada antes de você criar o gateway. Use o tempo de espera para finalizar a integração.
Não. Com apenas API, seu backend verifica o status do pagamento por conta própria. Se você precisar de notificações, use o Checkout Hospedado junto com a API.
As configurações do seu gateway decidem se pagamentos a menos e pagamentos a mais são aceitos. Se um pagamento chegar após a expiração da fatura, a Volet.com pode devolvê-lo ao cliente ou, em alguns casos, creditá-lo em sua conta. Um cliente que ainda deseja pagar pode precisar de um novo pedido de pagamento.
Pesquise o pedido através da API pelo seu orderId antes de responder.
Uma transferência pode ser visível na blockchain e ainda assim não corresponder à fatura: pode estar curta, atrasada ou enviada por outra rede.
Dê à sua equipe de suporte acesso aos detalhes do pagamento e concorde com antecedência quando eles devem escalar um caso para o suporte da Volet.com.
Não. Uma transação confirmada na blockchain não pode ser cancelada, e não há estornos de rede de cartões. Um reembolso é um pagamento separado sob sua própria política e regras de proteção ao consumidor aplicáveis.
Não. A Volet.com não fornece aquisição de cartões. Mantenha seu adquirente de cartões para pagamentos diretos com cartão.