PIX
Receba pagamentos PIX de forma instantânea através de QR CodesO 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
🔒 Validação de dados
🔒 Validação de dados
- Valide CPF/CNPJ antes de enviar a requisição
- Confirme que o valor de
amountcorresponde à soma dos itens - Use HTTPS em todas as chamadas
🔄 Idempotência
🔄 Idempotência
- Use
externalRefpara relacionar a cobrança com seu pedido interno - Trate reenvios de webhook de forma idempotente
📊 Monitoramento
📊 Monitoramento
- Acompanhe o tempo até a confirmação de pagamento
- Configure
postbackUrlpara 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