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
| Tipo | Descripción | Cobro Automático |
|---|---|---|
| card | Tarjeta de crédito/débito | Sí |
| bank_slip | Boleto bancario | No |
| pix | PIX (transferencia instantánea) | No |
| bank_transfer | Transferencia bancaria | No |
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:
- El cliente envía los datos de la tarjeta por el formulario del gateway
- El gateway retorna un
cardTokentemporal - El servidor usa el token para crear el cliente y la tarjeta en el gateway (Pagar.me)
- 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