Skip to main content

Cartão de Crédito

Tokenize os dados do cartão no navegador do cliente e finalize a cobrança no seu backend
O 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

A resposta é uma string — o token do 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

  • 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
  • Use externalRef para 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