Pular para o conteúdo principal

Ativar pagamentos em massa

Configure sua conta da Volet.com para enviar pagamentos pela API a freelancers, criadores, afiliados, parceiros ou outros destinatários.

Os pagamentos em massa custodiais são enviados da sua conta da Volet.com para usuários da Volet.com ou para carteiras cripto externas.

Integrações de pagamentos em massa não custodiais não exigem conta da Volet.com. Elas são executadas diretamente da sua própria carteira por meio de contratos inteligentes. Fale com a nossa equipe para saber os detalhes da integração.

Antes de começar​

Para usar os pagamentos em massa custodiais, você precisa de uma conta da Volet.com verificada.

Veja Verificação empresarial ou Verificação pessoal. Compare os tipos de conta: Business ou Personal.

Etapa 1: criar uma 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 da 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. URL pública associada a esta integração por API.

Exemplos:

  • https://example.com
  • https://app.example.com
  • https://t.me/example_bot

Etapa 3: configurar as permissões da API​

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

Para integrações de pagamentos, ative as permissões de que seu aplicativo precisa:

  • Realizar transações

    • Pagamentos para usuários da Volet.com — permite que seu aplicativo envie fundos para as contas da Volet.com dos destinatários.
    • Pagamentos para carteiras cripto externas — permite que seu aplicativo envie pagamentos em criptomoedas para endereços de carteiras externas.
    • Pagamentos em cripto a partir de carteiras fiduciárias — permite que seu aplicativo envie pagamentos em cripto a partir de saldos em moeda fiduciária com conversão automática.
    • Converter fundos entre carteiras da Volet.com — permite que seu aplicativo converta fundos entre suas próprias carteiras da Volet.com antes de enviar os pagamentos, se o seu fluxo exigir.

Você também pode precisar destas permissões:

  • Consultar saldo por carteira — permite que seu aplicativo consulte o saldo de uma carteira específica antes de criar pagamentos.
  • Buscar transação — permite que seu aplicativo consulte o status do pagamento e os detalhes da transação depois que ele é criado.
  • Histórico de transações — permite que seu aplicativo obtenha o histórico de transações para conciliação e relatórios.

Ative apenas as permissões necessárias para a sua integração.

Veja a referência da API para mais detalhes.

Etapa 4: aprovação​

Depois que a API for criada e configurada, não é necessária nenhuma aprovação adicional para usar a Mass Payout API.

Etapa 5: integrar​

Com a API configurada, você pode começar a enviar pagamentos pela API.

Veja:

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