Pular para o conteúdo principal

Integração com contratos inteligentes

Uma integração típica de pagamentos não custodiais tem três componentes:

  • Seu aplicativo
  • Um provedor de conexão de carteiras
  • O contrato inteligente de pagamento

O provedor de conexão de carteiras só conecta a carteira do cliente e solicita a assinatura da transação. O pagamento em si é executado pelo contrato inteligente na blockchain.

dica

Fale com a nossa equipe antes de iniciar a integração. Vamos fornecer os dados do contrato inteligente necessários e a ABI e ajudar você a escolher a arquitetura adequada para o seu aplicativo.

Fluxo de pagamento​

  1. O cliente chega à sua página de pagamento.
  2. O cliente conecta a carteira.
  3. Seu aplicativo prepara uma transação de pagamento.
  4. A transação é enviada à carteira conectada.
  5. O cliente confere e assina a transação.
  6. A carteira transmite a transação assinada para a blockchain.
  7. O contrato inteligente transfere o valor.
  8. A carteira recebe um hash da transação (txid) e o devolve ao seu aplicativo.
  9. Seu aplicativo acompanha a transação até ela atingir o estado de confirmação exigido.
  10. Seu sistema marca o pedido como pago.

Pré-requisitos​

Antes de integrar, você precisa de:

  • Um aplicativo frontend capaz de conectar carteiras cripto.
  • Um backend (recomendado) para criar solicitações de pagamento e acompanhar as transações na blockchain.
  • Os dados do contrato inteligente fornecidos pela Volet.com.
  • Um provedor de conexão de carteiras adequado às redes blockchain que você pretende aceitar.

Configuração inicial​

Etapa 1. Configure a conexão de carteiras​

Integre um provedor de conexão de carteiras adequado às redes blockchain que você pretende aceitar.

Opções comuns:

  • WalletConnect — Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche e outras redes compatíveis com EVM.
  • TronLink — Tron.
  • TON Connect — TON.
  • Solana Wallet Adapter — Solana.

Alguns provedores, como o WalletConnect, exigem um Project ID ou credenciais de API antes do uso.

Etapa 2. Obtenha os dados do contrato inteligente​

Fale com a Volet.com para receber o endereço do contrato inteligente, a ABI e os parâmetros específicos da integração.

Implementação do fluxo de pagamento​

Etapa 1. Conecte a carteira do cliente​

Peça ao cliente que conecte uma carteira compatível.

Por exemplo:

  • MetaMask ou Trust Wallet pelo WalletConnect.
  • TronLink para Tron.
  • Tonkeeper pelo TON Connect.
  • Phantom ou Solflare pelo Solana Wallet Adapter.

Etapa 2. Prepare a transação​

Prepare uma solicitação de transação no seu aplicativo.

Normalmente ela inclui:

  • Endereço da carteira de destino
  • Valor do pagamento
  • Token
  • Rede blockchain (chainId)
  • ID do pedido
  • Metadados opcionais

A transação pode ser preparada no frontend ou no backend.

Etapa 3. Solicite a assinatura da transação​

Envie a transação preparada à carteira conectada.

Com o chainId informado, a carteira seleciona automaticamente a rede blockchain e o endpoint RPC adequados.

O cliente confere os detalhes da transação.

Se estiver tudo certo, ele assina a transação na carteira.

Etapa 4. Transmita a transação​

Depois de assinada, a carteira transmite a transação para a blockchain pelo endpoint RPC adequado.

Se a rede aceitar a transação, a carteira recebe um hash da transação (txid) e o devolve ao seu aplicativo.

Armazene o hash da transação junto com o pedido.

Etapa 5. Verifique as confirmações da transação​

Monitore a blockchain com o hash da transação até o pagamento atingir o estado de confirmação exigido.

Quando a transação tiver confirmações suficientes, marque o pedido como pago no seu sistema.

Provedores RPC​

As carteiras dos clientes selecionam automaticamente um endpoint RPC com base no chainId da transação, então integrações básicas não exigem configuração adicional.

Se seu aplicativo faz muitas requisições à blockchain — por exemplo, para monitorar transações de pagamento ou consultar dados da blockchain em grande escala —, considere usar:

  • Um provedor RPC dedicado.
  • Seu próprio nó RPC.

Uma infraestrutura dedicada ajuda a evitar os limites de requisições dos RPCs públicos e melhora a confiabilidade sob carga alta.

Próximos passos​

  • Consulte a referência do contrato inteligente.
  • Teste os cenários de pagamento bem-sucedido e com falha.
  • Verifique o tratamento das confirmações de transações.
  • Implante em produção.