Stripe - Crear Reembolso

Descripcion

Este módulo permite crear reembolsos para pagos realizados previamente. Puede ser un reembolso total o parcial, con opción de especificar el motivo.

Configuración

Credenciales Requeridas

• Secret Key: Clave secreta de Stripe

Parámetros

Parámetro	Tipo	Requerido	Descripción
credentials_id	credential	Sí	Credenciales de Stripe
payment_intent_id	string	Sí*	ID del Payment Intent (pi_xxx)
charge_id	string	Sí*	ID del Charge (ch_xxx) - alternativo
amount	number	No	Monto a reembolsar (vacío = total)
reason	select	No	Motivo del reembolso
metadata	string	No	Metadatos adicionales (JSON)

*Se requiere payment_intent_id o charge_id

Motivos de Reembolso

• duplicate: Pago duplicado
• fraudulent: Pago fraudulento
• requested_by_customer: Solicitado por el cliente

Salida

{
  "success": true,
  "refund": {...},
  "refund_id": "re_3MtwBwLkdIwHu7ix28a3tqPa",
  "status": "succeeded",
  "amount": 99.99,
  "currency": "usd",
  "message": "Reembolso re_3MtwBw... creado (succeeded)"
}

Estados del Reembolso

• pending: Pendiente
• succeeded: Exitoso
• failed: Fallido
• canceled: Cancelado

Ejemplo de Uso

Reembolso total

{
  "payment_intent_id": "pi_3MtwBwLkdIwHu7ix28a3tqPa"
}

Reembolso parcial

{
  "payment_intent_id": "pi_3MtwBwLkdIwHu7ix28a3tqPa",
  "amount": 25.00,
  "reason": "requested_by_customer"
}

Reembolso con metadatos

{
  "charge_id": "ch_3MtwBwLkdIwHu7ix28a3tqPa",
  "reason": "duplicate",
  "metadata": "{\"ticket_id\": \"SUPPORT-123\"}"
}

API Utilizada

• Endpoint: POST /v1/refunds
• Documentación: Stripe Refunds API

Notas

• Si no se especifica monto, se reembolsa el total
• Los reembolsos parciales pueden hacerse múltiples veces
• El monto se convierte automáticamente a centavos
• Los reembolsos pueden tardar 5-10 dias en reflejarse en la cuenta del cliente

Nodos relacionados

• StripeGetPaymentIntents - Obtener el Payment Intent a reembolsar
• StripeCreatePaymentIntent - Crear pagos que luego pueden reembolsarse
• StripeGetCustomers - Obtener datos del cliente del pago