Redsys - Crear Preautorización

Descripción

Este modulo permite crear una preautorización (retención de fondos) en la pasarela Redsys. Los fondos se retienen en la tarjeta del cliente sin cobrar, y se pueden confirmar o anular posteriormente.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Redsys
amount	number	Sí	Importe a retener en euros
order_number	string	Sí	Número de pedido único
currency	select	No	Moneda (978=EUR por defecto)
card_number	string	No	Número de tarjeta
expiry_date	string	No	Fecha caducidad (YYMM)
cvv	string	No	CVV de la tarjeta
titular	string	No	Nombre del titular
product_description	string	No	Descripción del producto
merchant_url	string	No	URL para notificación
url_ok	string	No	URL de retorno si OK
url_ko	string	No	URL de retorno si KO
direct_payment	boolean	No	Pago directo sin redirección

Credenciales

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

Campo	Descripción
merchant_code	Código de comercio (FUC) proporcionado por el banco
secret_key	Clave secreta de firma SHA-256
terminal	Número de terminal (por defecto: 1)
test_mode	Modo de pruebas (true/false)

Salida

{
  "success": true,
  "response_code": "0000",
  "order": "0001234567",
  "authorization_code": "123456",
  "amount": 100.00,
  "message": "Preautorización creada: 0001234567"
}

Flujo de Preautorización

1. Crear preautorización (este módulo) - Retiene el importe en la tarjeta
2. Confirmar preautorización - Captura el importe retenido (total o parcial)
3. Anular preautorización - Libera el importe si no se confirma

Ejemplo de Uso

{
  "credentials_id": "redsys_tienda",
  "amount": 200.00,
  "order_number": "0001234567",
  "currency": "978",
  "direct_payment": false,
  "merchant_url": "https://mitienda.com/webhook/redsys"
}

API Utilizada

• API: Redsys REST API
• Tipo de transacción: 1 (Preautorización)
• Documentación: https://pagosonline.redsys.es/conexión-rest.html

Notas

• La preautorización retiene fondos sin cobrar
• Debe confirmarse en un plazo máximo (normalmente 7-30 dias según el banco)
• Se puede confirmar por un importe menor al preautorizado
• Si no se confirma, el importe se libera automáticamente

Nodos relacionados

• RedsysConfirmPreauthorization - Confirmar y cobrar la preautorización
• RedsysCancelPreauthorization - Anular y liberar los fondos
• RedsysGetPayment - Consultar estado de la preautorización