Saltar al contenido principal

Métodos de Pago

Cada cuenta de cobro puede tener múltiples métodos de pago almacenados. Uno de ellos se marca como predeterminado para cobros automáticos.

Tipos Soportados

TipoDescripciónCobro Automático
cardTarjeta de crédito/débito
bank_slipBoleto bancarioNo
pixPIX (transferencia instantánea)No
bank_transferTransferencia bancariaNo

Nota: Solo la tarjeta de crédito soporta cobro automático (charge_automatically).

Tarjeta de Crédito

Datos Almacenados

  • Marca (Visa, Mastercard, Elo, Amex, Hipercard)
  • Primeros 6 dígitos (BIN)
  • Últimos 4 dígitos
  • Nombre del titular
  • Mes y año de vencimiento
  • Fingerprint (identificador único de la tarjeta en el gateway)

Tokenización

La tarjeta es tokenizada en el lado del cliente vía SDK del gateway y almacenada de forma segura:

  1. El cliente envía los datos de la tarjeta por el formulario del gateway
  2. El gateway retorna un cardToken temporal
  3. El servidor usa el token para crear el cliente y la tarjeta en el gateway (Pagar.me)
  4. Solo los tokens del gateway y datos enmascarados son almacenados

Monitoreo de Vencimiento

El sistema verifica automáticamente las tarjetas que vencen en los próximos 30 días y puede enviar notificaciones proactivas al cliente.

Boleto Bancario (bank_slip)

  • Generado para cada cobro individual
  • Posee código de barras y URL para descarga del PDF
  • Plazo de vencimiento configurable (predeterminado: 3 días)
  • Confirmación vía webhook del gateway cuando es pagado

PIX

  • QR Code generado para cada cobro
  • Formato EMV con imagen PNG/base64
  • Expiración predeterminada: 30 minutos
  • Confirmación en tiempo real vía webhook

Transferencia Bancaria (bank_transfer)

Datos almacenados:

  • Código del banco, nombre del banco
  • Sucursal y cuenta
  • Tipo: corriente o ahorro
  • Nombre y documento del titular

La confirmación es manual — el operador necesita verificar la recepción.

Método Predeterminado

  • Cada cuenta de cobro tiene un método predeterminado
  • El primer método creado se define automáticamente como predeterminado
  • Al eliminar el método predeterminado, el siguiente método activo es promovido

Eliminación

Al eliminar un método de pago:

  • Valida que no haya pagos pendientes/procesando con este método
  • Para tarjetas: elimina la tarjeta del gateway
  • Si era el predeterminado: reasigna a otro método activo
  • El status cambia a removed