Redsys - Crear Pago

Descripcion

Este modulo permite crear un pago o autorizacion en la pasarela de pagos Redsys. Soporta pagos directos (con datos de tarjeta) y pagos con redireccion al formulario seguro de Redsys.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Redsys
amount	number	Sí	Importe en euros (ej: 100.00)
order_number	string	Sí	Número de pedido único (4-12 caracteres)
currency	select	No	Moneda (978=EUR, 840=USD, 826=GBP)
card_number	string	No	Número de tarjeta
expiry_date	string	No	Fecha caducidad (YYMM, ej: 2512)
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 (webhook)
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
identifier	string	No	Identificador para pagos COF

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)

Salida

{
  "success": true,
  "response_code": "0000",
  "order": "0001234567",
  "authorization_code": "123456",
  "amount": 100.00,
  "currency": "978",
  "card_brand": "1",
  "message": "Pago autorizado: 0001234567"
}

Códigos de Respuesta

Código	Significado
0000-0099	Operación aprobada
0101	Tarjeta caducada
0102	Tarjeta bloqueada
0180	Tarjeta no válida
0184	Error autenticación
0190	Denegada sin especificar
0900-0999	Operación pendiente

Ejemplo de Uso

{
  "credentials_id": "redsys_tienda",
  "amount": 49.99,
  "order_number": "0001234567",
  "currency": "978",
  "direct_payment": false,
  "merchant_url": "https://mitienda.com/webhook/redsys",
  "url_ok": "https://mitienda.com/pago-ok",
  "url_ko": "https://mitienda.com/pago-error"
}

API Utilizada

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

Notas

• El numero de pedido debe ser unico por cada transaccion
• El importe se convierte automaticamente a centimos
• Para pagos con redireccion, no se envian datos de tarjeta
• El modo test usa el entorno sis-t.redsys.es

Nodos relacionados

• RedsysGetPayment - Consultar estado del pago
• RedsysRefund - Devolver un pago realizado
• RedsysCreatePreauthorization - Preautorizar en lugar de cobrar directamente
• RedsysRecurringPayment - Cobros recurrentes con token