Redsys - Pago Recurrente (COF)

Descripcion

Este modulo permite realizar pagos recurrentes utilizando la funcionalidad Credential on File (COF) de Redsys. Permite cobrar a clientes sin necesidad de que introduzcan sus datos de tarjeta en cada transaccion, ideal para suscripciones y pagos periodicos.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Redsys
amount	number	Sí	Importe del cobro en euros
order_number	string	Sí	Número de pedido único
identifier	string	Sí	Identificador COF (de la primera transacción)
currency	select	No	Moneda (978=EUR por defecto)
cof_type	select	No	Tipo de operación COF
cof_ini	select	No	Indicador de secuencia (S=Primera, N=Subsecuente)
product_description	string	No	Descripción del cobro
exempt_authentication	boolean	No	Exento de autenticación 3DS (MIT)
merchant_url	string	No	URL para notificación

Credenciales

Este modulo requiere credenciales de tipo Redsys con los siguientes campos:

Campo	Descripcion
merchant_code	Codigo de comercio (FUC) proporcionado por el banco
secret_key	Clave secreta de firma SHA-256
terminal	Numero de terminal (por defecto: 1)
test_mode	Modo de pruebas (true/false)

Tipos de COF (cof_type)

Valor	Descripción
R	Recurrente (suscripciones)
I	A plazos (Installment)
H	Reauthorization
E	Resubmission
D	Delayed
M	Incremental
N	No-show

Salida

{
  "success": true,
  "response_code": "0000",
  "order": "0001234567",
  "authorization_code": "345678",
  "amount": 9.99,
  "identifier": "12345678901234567890",
  "message": "Pago recurrente autorizado: 0001234567"
}

Flujo de Pagos Recurrentes

1. Primera transacción (cof_ini=S): El cliente paga con 3D Secure
   • Obtener el identifier de la respuesta
   • Guardar para futuros cobros
2. Transacciones subsecuentes (cof_ini=N): Cobros sin intervención del cliente
   • Usar el identifier guardado
   • No requiere autenticación 3DS

Ejemplo de Uso

{
  "credentials_id": "redsys_tienda",
  "amount": 9.99,
  "order_number": "SUB-202401-001",
  "identifier": "12345678901234567890",
  "cof_type": "R",
  "cof_ini": "N",
  "exempt_authentication": true,
  "product_description": "Suscripcion mensual Premium"
}

API Utilizada

• API: Redsys REST API
• Tipo de transaccion: 0 (Autorizacion) con parametros COF
• Documentacion: https://pagosonline.redsys.es/conexion-rest.html

Notas

• El identifier es proporcionado por Redsys en la primera transaccion
• Los cobros subsecuentes no requieren datos de tarjeta
• La exencion MIT (Merchant Initiated Transaction) evita el 3D Secure
• Ideal para suscripciones, membresias y pagos periodicos

Nodos relacionados

• RedsysCreatePayment - Crear el primer pago para obtener el identifier
• RedsysGetPayment - Consultar estado del cobro recurrente
• RedsysRefund - Devolver un cobro recurrente