Pular para o conteúdo principal

Criar um gateway de pagamento

Para usar gateways de pagamento custodiais, você precisa de uma conta da Volet.com verificada. Se ainda não tiver uma, veja Criar uma conta, Verificação empresarial ou Verificação pessoal.

Integrações de pagamento não custodiais não exigem conta da Volet.com. Fale com a nossa equipe para saber os detalhes da integração.

Escolha o método de integração​

  • Use o Hosted Checkout se quiser a integração mais rápida, com uma página de pagamento pronta hospedada pela Volet.com. Ele também é o único método de integração que aceita pagamentos com saldo de contas da Volet.com.
  • Use a API se quiser criar seu próprio fluxo de pagamento e controlar totalmente a experiência do cliente.

Compare API, Hosted Checkout e contratos inteligentes para escolher o método de integração certo para o seu negócio.

observação

Você pode alterar essas configurações a qualquer momento depois de criar o gateway.

Opção 1: criar um gateway Hosted Checkout​

Etapa 1: criar um Hosted Checkout​

Entre no seu painel da Volet.com, acesse Ferramentas de pagamento e clique em Criar na seção Hosted Checkout.

Etapa 2: configurar os métodos de pagamento​

Na primeira aba, ative os métodos de pagamento que deseja aceitar:

MétodoDescrição
Usuários da Volet.comOs clientes pagam com a conta da Volet.com.
Carteiras criptoOs clientes pagam em BTC, ETH, USDT, USDC e outros tokens compatíveis a partir de qualquer carteira cripto.

Mais sobre cada método:

Para cada método, configure Quem paga a taxa: defina se a taxa de processamento é descontada do valor recebido (O lojista paga) ou somada ao valor pago pelo cliente (O comprador paga).

Etapa 3: configurar as opções​

Configure a página do Hosted Checkout e as URLs de callback.

Opções de processamento de pagamentos​

  1. Usar assinatura digital nas solicitações do Hosted Checkout.

    Assina as solicitações de pagamento e as notificações de callback com a senha do Hosted Checkout. Isso ajuda a confirmar que as solicitações vêm da Volet.com e não foram alteradas no caminho.

    Recomendamos manter essa opção ativada em produção.

  2. Aceitar pagamento a menor.

    Permite concluir pedidos quando o cliente envia menos que o valor solicitado.

    Pode ser útil em pagamentos com criptomoedas, em que taxas de rede, cálculos manuais ou variações de câmbio podem resultar em um pagamento um pouco menor que o esperado.

  3. Aceitar pagamento a maior.

    Permite concluir pedidos quando o cliente envia mais que o valor solicitado.

    Pode ser útil quando o cliente transfere por engano um valor maior que o solicitado.

Configuração do Hosted Checkout​

  1. Nome do Hosted Checkout. Nome que identifica este Hosted Checkout na sua conta da Volet.com.

  2. URL do site, app, bot ou agente de IA. Informe a URL pública associada a este gateway de pagamento. Essa URL também é exibida aos clientes durante o pagamento.

Exemplos:

  1. E-mail para notificações. Endereço de e-mail opcional que recebe notificações sobre as transações processadas por esta configuração do Hosted Checkout.

  2. E-mail exibido no Hosted Checkout. Reservado para uso futuro.

  3. Senha do Hosted Checkout. Chave secreta usada para assinar solicitações de pagamento e verificar notificações de callback. Mantenha-a em sigilo e não a exponha no código do lado do cliente.

Configuração das URLs de status​

Depois, configure as URLs de callback e de redirecionamento. Você pode omitir esses parâmetros e/ou informá-los no formulário da solicitação de pagamento.

  1. Success URL. URL para onde o cliente é redirecionado após um pagamento bem-sucedido.

  2. Failed URL. URL para onde o cliente é redirecionado se o pagamento falhar ou for cancelado.

  3. Status URL. Endpoint do servidor que recebe as notificações de status dos pagamentos. Use essas notificações para atualizar automaticamente o status dos pedidos no seu sistema.

Para Success URL, Failed URL e Status URL, você pode escolher o método HTTP:

  • GET — os parâmetros são enviados na query string.
  • POST — os parâmetros são enviados no corpo da requisição.

Etapa 4: personalizar a aparência (opcional)​

Opcional; pode ser configurado depois.

Você pode personalizar a página do Hosted Checkout com seu logotipo e as cores da sua marca.

Etapa 5: aprovação​

Gateways recém-criados precisam da aprovação de um administrador antes de aceitar pagamentos reais.

A aprovação costuma levar algumas horas.

Você receberá um e-mail quando o gateway for aprovado e estiver pronto para uso.

observação

Não é possível processar pagamentos reais até o gateway ser aprovado. Aproveite esse tempo para concluir a integração no seu site.

Etapa 6: integrar o Hosted Checkout​

Após a aprovação, você pode integrar o Hosted Checkout ao seu site, aplicativo, bot ou agente de IA.

Veja: Integração do Hosted Checkout

Opção 2: criar um gateway API​

Etapa 1: criar um gateway API​

Entre no seu painel da Volet.com, acesse Ferramentas de pagamento e clique em Criar na seção API.

Etapa 2: configurar as opções da API​

Configure as opções básicas da API.

  1. Nome da API. Nome interno do gateway API. Usado apenas dentro da sua conta da Volet.com.

  2. Lista de IPs permitidos. Lista de endereços IP com acesso à API.

    Você pode:

    • Informar um ou mais endereços IP manualmente.
    • Clicar em Adicionar IP atual para incluir automaticamente seu endereço IP atual.
    • Ativar Permitir todos os IPs para desativar as restrições de IP (não recomendado em produção).

  3. Senha da API. Chave secreta usada para autenticar as requisições à API. Mantenha-a em sigilo e não a exponha no código do lado do cliente.

  4. URL do site, app, bot ou agente de IA. Informe a URL pública associada a esta integração por API.

Exemplos:

  1. E-mail para notificações. Endereço de e-mail opcional que recebe notificações sobre as transações processadas por este gateway API.

Etapa 3: configurar as permissões da API​

Escolha quais permissões estarão disponíveis para este gateway API.

Para integrações de recebimento de pagamentos, ative:

  • Realizar transações
    • Aceitar pagamentos cripto — permite que seu aplicativo crie faturas de pagamento e aceite pagamentos em criptomoedas a partir de carteiras cripto.
  • Buscar transação — permite que seu aplicativo consulte o status do pagamento e os detalhes da transação depois que uma fatura é criada.

Integrações por API não usam URLs de callback. Depois de criar uma fatura, seu aplicativo deve usar Buscar transação para verificar o status atual do pagamento.

Permissões adicionais, como consulta de saldo, histórico de transações, conversões e pagamentos em massa, podem ser ativadas depois, se a sua integração precisar. Veja a referência da API para mais detalhes.

Etapa 4: aprovação​

Gateways API recém-criados precisam da aprovação de um administrador antes de processar transações reais.

A aprovação costuma levar algumas horas.

Você receberá um e-mail quando o gateway API for aprovado e estiver pronto para uso.

observação

Não é possível processar transações reais até o gateway API ser aprovado.

Etapa 5: integrar​

Após a aprovação, você pode começar a receber pagamentos pela API.

Veja:

  • Integração por API — guia prático de integração de um gateway de pagamento por API.
  • Referência da API — documentação completa de métodos, parâmetros e respostas.