Integração com contratos inteligentes

Receba pagamentos em criptomoedas diretamente na sua própria carteira com os contratos inteligentes da Volet.com. Os clientes conectam as carteiras cripto deles e aprovam as transações, e o contrato inteligente processa o pagamento e distribui os fundos e a taxa de processamento on-chain.

Nem você nem seus clientes precisam de uma conta Volet.com. Você controla a carteira de recebimento e gerencia a confirmação dos pagamentos no seu próprio aplicativo.

Importante: esta integração não usa o Hosted Checkout nem faturas da Merchant API. Seu aplicativo oferece a interface de pagamento e verifica os pagamentos diretamente na blockchain. A Volet.com não envia notificações de status de pagamento neste fluxo.

Como funciona

Uma integração de pagamentos não custodiais envolve três componentes:

• Seu aplicativo: cria os pedidos, inicia os pagamentos e verifica as transações.
• A carteira do cliente: conecta-se ao seu aplicativo e assina as transações de pagamento.
• O contrato inteligente da Volet.com: processa os pagamentos, transfere os fundos para a sua carteira e cobra a taxa de processamento.

Fluxo de pagamento

1. Crie um pedido. Seu backend registra o valor do pagamento, o ativo, a rede blockchain e a carteira de recebimento do lojista.
2. Conecte a carteira do cliente. Seu aplicativo solicita a conexão de uma carteira cripto compatível.
3. Calcule o pagamento. A função previewPayment() do contrato inteligente retorna a taxa de processamento e o valor que o cliente deve pagar.
4. Solicite o pagamento. O cliente revisa e assina a transação. Pagamentos com tokens como USDT podem exigir antes uma aprovação separada.
5. A transação é processada. O contrato inteligente transfere os fundos para a sua carteira e cobra a taxa de processamento.
6. Registre a transação. Seu aplicativo salva o hash da transação (txid) e o associa ao pedido.
7. Verifique o pagamento. Seu backend verifica a transação de forma independente: status, rede, contrato, ativo, destinatário, valor e finalidade na blockchain.
8. Conclua o pedido. Depois que a verificação for bem-sucedida, seu aplicativo marca o pedido como pago e o entrega uma única vez.

Importante: um hash de transação, uma aprovação na carteira ou um status de transação bem-sucedido não confirmam, sozinhos, que o pedido foi pago. Sempre verifique os dados do pagamento no backend antes de entregar um pedido.

Escolha sua rede

Escolha o guia de integração de acordo com as redes e os ativos que você quer receber.

Rede	Ativos nestes guias	Carteiras dos clientes	Guia de integração
Ethereum e BNB Smart Chain	ETH, BNB, USDT (ERC-20 e BEP-20)	MetaMask e carteiras compatíveis com WalletConnect	Integração EVM
TRON	TRX, USDT (TRC-20)	TronLink; WalletConnect por meio de uma integração separada	Integração TRON

Outras redes e ativos podem exigir implementações separadas. Veja Receber pagamentos cripto não custodiais para uma visão geral do produto e das opções disponíveis.

Antes de começar

Você vai precisar de:

• Carteira do lojista: uma carteira cripto que você controla para receber os pagamentos.
• Aplicativo: um site ou aplicativo com interface de pagamento.
• Backend e banco de dados: para criar pedidos, armazenar os dados das transações e verificar os pagamentos.
• Integração de carteiras: uma biblioteca de conexão de carteiras compatível com a rede escolhida.
• Dados do contrato inteligente: os endereços dos contratos processadores, a ABI e os parâmetros fornecidos pela Volet.com.
• Acesso à blockchain: um provedor RPC ou um serviço de blockchain hospedado para verificar as transações.

Dependendo da integração, você também pode precisar de um Project ID do WalletConnect ou de uma chave de API do TronGrid.

Fale com a nossa equipe para obter os dados do contrato inteligente e conversar sobre a sua integração.

Taxas de processamento

O contrato inteligente calcula a taxa de processamento com previewPayment(). Seu aplicativo escolhe quem paga a taxa:

• O cliente paga: a taxa é somada ao valor do pagamento. O lojista recebe o valor solicitado.
• O lojista paga: a taxa é descontada do valor solicitado. O lojista recebe o restante.

As taxas de rede da blockchain, como o gas no Ethereum ou os custos de Energy e Bandwidth na TRON, são cobradas à parte da taxa de processamento da Volet.com.

Sempre use os valores retornados por previewPayment() em vez de calcular a taxa manualmente.

Os parâmetros do contrato e o cálculo da taxa estão descritos na Referência de contratos inteligentes.

Guias de integração

Siga estas etapas para concluir a integração:

1. Implemente o fluxo de pagamento. Use o guia de Ethereum e BNB Smart Chain ou o guia de TRON para conectar as carteiras dos clientes, configurar os contratos inteligentes e enviar os pagamentos.
2. Implemente a verificação de pagamentos. Siga Verificação de pagamentos e acompanhamento de pedidos para associar as transações da blockchain aos pedidos e evitar entregas duplicadas.
3. Teste a integração. Antes do lançamento, teste pagamentos bem-sucedidos e com falha, aprovações de tokens, transações rejeitadas e a verificação de pagamentos.

Recursos adicionais:

• Referência de contratos inteligentes — endereços dos processadores, decimais dos tokens, funções e parâmetros dos contratos.
• Solução de problemas — erros comuns de carteiras, transações e contratos.

Exemplos de integração

Os guias de cada rede incluem exemplos em HTML que você pode abrir no navegador ou baixar:

• Exemplo EVM (example-evm.html): conexão de carteiras, cálculo de taxas, pagamentos em ETH, BNB e USDT e acompanhamento de transações.
• Exemplo TRON (example-tron.html): conexão do TronLink, cálculo de taxas, pagamentos em TRX e USDT e acompanhamento de transações.

Cada guia explica como usar o seu exemplo.

Importante: os dois exemplos usam contratos na mainnet. Qualquer pagamento confirmado na sua carteira movimenta fundos reais. Para testar pagamentos, você precisa de duas carteiras: uma para enviar os fundos e outra para recebê-los.

Limitações da demo: os exemplos armazenam o histórico de transações no localStorage do navegador. Eles não incluem um backend de produção nem uma verificação completa dos pagamentos. Adapte e teste os exemplos antes de receber pagamentos reais de clientes.

Integração com um assistente de programação com IA

Um assistente de programação com IA pode ajudar você a integrar os pagamentos com contratos inteligentes da Volet.com ao seu aplicativo.

Use o nosso prompt de integração pronto para usar, que cobre a conexão de carteiras, o processamento de pagamentos, a verificação no backend, o acompanhamento de pedidos e os testes.

Forneça ao assistente de IA o prompt, o código-fonte do seu aplicativo e os guias de integração correspondentes.

Importante: revise e teste todo o código gerado por IA antes de processar pagamentos reais. Confira os endereços dos contratos, a lógica de validação dos pagamentos e o tratamento das transações.

Relacionados

• Receber pagamentos cripto não custodiais — saiba como funciona o recebimento de pagamentos não custodiais e seus recursos.