Cartão de Crédito
Tokenize os dados do cartão no navegador do cliente e finalize a cobrança no seu backendO fluxo de cobrança em cartão acontece em duas etapas: tokenização do cartão (feita no navegador do comprador, usando apenas sua Public Key) e criação da transação (feita no seu backend, com o token gerado).
🚀 Como Funciona
💳 Cliente digita o cartão
No seu checkout, o comprador informa os dados do cartão
🔒 Cartão é tokenizado
O navegador chama a Velfy diretamente com sua Public Key, e recebe um token
📤 Seu backend cria a cobrança
Envie o token recebido no campo
card.hash⚡ Resposta imediata
A cobrança é processada de forma síncrona: a resposta já traz
paid ou refused🛠️ Implementação
1. Tokenizar o cartão
O token retornado tem validade curta. Gere-o imediatamente antes de criar a transação.
2. Criar a transação com o token
3. Resposta
📊 Parâmetros Detalhados
Campos específicos do cartão
Consulte os campos comuns a toda transação para os demais parâmetros (
amount, customer, items, etc).📋 Status da Transação
🛡️ Boas Práticas
🔒 Segurança
🔒 Segurança
- Sempre tokenize o cartão no navegador do cliente, usando apenas a Public Key
- Nunca envie o número do cartão para o seu próprio backend
- 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
🎯 Próximos Passos
🔗 Configurar Webhooks
Receba a confirmação do pagamento automaticamente
🧾 Boleto
Aceite também pagamentos via boleto