CONTAS A PAGAR

Como pagar fornecedores via Pix usando USDC

Sua empresa usa saldo em USDC e o fornecedor recebe reais via Pix. O fluxo depende da rede da carteira, da verificação da conta e da autorização para pagamentos a terceiros.

PixPix
USDTUSDT
USDCUSDC
BaseBase

O que precisa estar habilitado

Pagar um fornecedor é uma operação para um beneficiário diferente do titular da conta. Nas subcontas, operações para terceiros são desabilitadas por padrão e precisam de habilitação explícita. Uma chave de API ou uma cotação não concede essa permissão.

FluxoAtivo, rede e condição
Conta e beneficiárioVerificação aprovada e permissão para operar para terceiros. Confirme com o time como identificar corretamente o beneficiário no fluxo da sua empresa.
Rede e ativoUSDC em Base, Polygon ou Solana, conforme a documentação de payout e a habilitação da conta. O suporte da wallet não substitui o suporte do endpoint.
Saldo e preçoSaldo suficiente para o pagamento e a taxa. Confirme o ativo efetivamente debitado: alguns fluxos podem priorizar saldo em real tokenizado antes de usar USDC.
TesteO sandbox simula o Pix e usa Base Sepolia nos fluxos suportados. Ele não comprova liquidação bancária nem habilitação de produção.

Do saldo em USDC ao Pix do fornecedor

A integração deve confirmar o destinatário e o valor antes do envio. A liquidação só é confirmada no estado final da operação.

  1. 1Escolha a carteira e o escopo da subconta corretos. Confira rede, saldo e permissões.
  2. 2Resolva o beneficiário em POST /api/wallet/payout/beneficiary. Confira nome, documento mascarado e banco com o fornecedor.
  3. 3Mostre o valor em reais, o ativo debitado, a taxa e a cotação para aprovação. Use o quoteId retornado pelo fluxo de beneficiário conforme o contrato da API.
  4. 4Envie POST /api/wallet/payout com os dados exigidos da carteira, do beneficiário e da operação. Use um externalId estável por pagamento para proteger retentativas.
  5. 5Guarde transactionId e externalId junto à obrigação a pagar. Consulte GET /api/wallet/payout/{transactionId} e só baixe o título quando COMPLETED.
  6. 6Em timeout, consulte o pagamento existente. Repetir com um novo identificador pode criar uma segunda operação.

Taxa, câmbio e conciliação são coisas diferentes

A taxa de serviço pública de off-ramp vai de 2% a 0,5% conforme volume, com mínimo de R$ 0,75 por operação. Uma operação de R$ 1.000 na faixa de 2% tem R$ 20 de taxa de serviço; a quantidade de USDC debitada depende da cotação da operação. O contrato negociado pode prevalecer.

  • Guarde valor em BRL, ativo e rede debitados, taxa, identificador e estado final no registro do pagamento.
  • Confirme com sua contabilidade os documentos e registros necessários para a operação.

Perguntas frequentes

Condições antes de integrar contas a pagar.

O fornecedor precisa ter uma carteira cripto?

Não para receber o Pix: ele recebe reais na conta vinculada à chave ou ao QR Code usado. Sua empresa precisa ter o fluxo de payout e os pagamentos para terceiros habilitados.

Basta ter USDC em qualquer rede?

Não. O payout depende da rede e da carteira suportadas, do saldo, da verificação e das permissões da conta. Consulte a referência de payout antes de enviar fundos.

Uma resposta 202 significa que o fornecedor recebeu?

Não. Significa que a operação foi aceita. Acompanhe o transactionId até o estado final e baixe a obrigação apenas depois de COMPLETED.

Pronto para começar?

Confirme a habilitação para terceiros e os limites da conta antes de integrar pagamentos de fornecedores.