Skip to main content

PIX

Receba pagamentos PIX de forma instantânea através de QR Codes
O método pix permite gerar cobranças instantâneas com QR Code e código copia e cola. Ideal para vendas online e qualquer situação onde você precisa receber um pagamento rapidamente.

🚀 Como Funciona

📱 QR Code gerado

Você cria a cobrança e recebe um QR Code e código copia e cola

💳 Cliente paga

O cliente escaneia o QR Code ou cola o código no app do banco

⚡ Confirmação instantânea

Você recebe a confirmação via webhook assim que o PIX é compensado

💰 Saldo disponível

O valor fica disponível na sua conta Velfy

🛠️ Implementação Rápida

1. Criar a cobrança PIX

2. Resposta com QR Code

3. Exibir o QR Code para o cliente

📊 Parâmetros Detalhados

Campo específico do PIX

Consulte os campos comuns a toda transação para os demais parâmetros (amount, customer, items, etc).

📋 Status da Transação

🛡️ Boas Práticas

  • Valide CPF/CNPJ antes de enviar a requisição
  • Confirme que o valor de amount corresponde à soma dos itens
  • Use HTTPS em todas as chamadas
  • Use externalRef para relacionar a cobrança com seu pedido interno
  • Trate reenvios de webhook de forma idempotente
  • Acompanhe o tempo até a confirmação de pagamento
  • Configure postbackUrl para não depender apenas de polling

🎯 Próximos Passos

🔗 Configurar Webhooks

Receba a confirmação do pagamento automaticamente

💳 Cartão de Crédito

Aceite também pagamentos com cartão