Pular para o conteúdo principal

Métodos de Pagamento

Cada conta de cobrança pode ter múltiplos métodos de pagamento armazenados. Um deles é marcado como padrão para cobranças automáticas.

Tipos Suportados​

TipoDescriçãoCobrança Automática
cardCartão de crédito/débitoSim
bank_slipBoleto bancárioNão
pixPIX (transferência instantânea)Não
bank_transferTransferência bancáriaNão

Nota: Apenas cartão de crédito suporta cobrança automática (charge_automatically).

Cartão de Crédito​

Dados Armazenados​

  • Bandeira (Visa, Mastercard, Elo, Amex, Hipercard)
  • Primeiros 6 dígitos (BIN)
  • Últimos 4 dígitos
  • Nome do titular
  • Mês e ano de validade
  • Fingerprint (identificador único do cartão no gateway)

Tokenização​

O cartão é tokenizado no lado do cliente via SDK do gateway e armazenado de forma segura:

  1. Cliente envia dados do cartão pelo formulário do gateway
  2. Gateway retorna um cardToken temporário
  3. O servidor usa o token para criar o cliente e cartão no gateway (Pagar.me)
  4. Apenas os tokens do gateway e dados mascarados são armazenados

Monitoramento de Validade​

O sistema verifica automaticamente cartões que vencem nos próximos 30 dias e pode enviar notificações proativas ao cliente.

Boleto Bancário (bank_slip)​

  • Gerado para cada cobrança individual
  • Possui código de barras e URL para download do PDF
  • Prazo de vencimento configurável (padrão: 3 dias)
  • Confirmação via webhook do gateway quando pago

PIX​

  • QR Code gerado para cada cobrança
  • Formato EMV com imagem PNG/base64
  • Expiração padrão: 30 minutos
  • Confirmação em tempo real via webhook

Transferência Bancária (bank_transfer)​

Dados armazenados:

  • Código do banco, nome do banco
  • Agência e conta
  • Tipo: corrente ou poupança
  • Nome e documento do titular

A confirmação é manual — o operador precisa verificar o recebimento.

Método Padrão​

  • Cada conta de cobrança tem um método padrão
  • O primeiro método criado é automaticamente definido como padrão
  • Ao remover o método padrão, o próximo método ativo é promovido

Remoção​

Ao remover um método de pagamento:

  • Valida que não há pagamentos pendentes/processando com este método
  • Para cartões: deleta o cartão do gateway
  • Se era o padrão: reatribui para outro método ativo
  • Status muda para removed