Redsys - Devolución

Descripción

Este modulo permite realizar devoluciones totales o parciales de pagos realizados previamente a traves de la pasarela Redsys. Las devoluciones parciales son acumulativas hasta el importe total del pago original.

Configuración

Campo	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Redsys
order_number	string	Sí	Número de pedido original
amount	number	Sí	Importe a devolver en euros
currency	select	No	Moneda (978=EUR por defecto)
merchant_url	string	No	URL para notificació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": "789012",
  "amount": 50.00,
  "message": "Devolución realizada: 0001234567 por 50€"
}

Ejemplo de Uso

1. Cliente compra producto por 100 EUR
2. Devuelve un artículo de 30 EUR
3. Se hace devolución parcial de 30 EUR
4. Mas tarde devuelve otro artículo de 70 EUR
5. Se hace segunda devolución por 70 EUR (total devuelto: 100 EUR)

API Utilizada

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

Notas

• Solo se pueden devolver pagos confirmados/autorizados
• Las devoluciones parciales son acumulativas
• El importe total devuelto no puede superar el pago original
• El tiempo de devolución depende del banco emisor (1-10 dias habiles)
• Algunas entidades permiten devoluciones hasta 180 dias después del pago

Nodos relacionados

• RedsysCreatePayment - Crear el pago original
• RedsysGetPayment - Consultar estado del pago antes de devolver
• RedsysRecurringPayment - Pagos recurrentes que pueden requerir devolución