Stripe Refund
Stripe Refund gestiona las devoluciones de tu cuenta de Stripe. Puede devolver un cobro completo o solo una parte, consultar una devolución concreta o la lista de devoluciones, y añadir una nota a una devolución.
Cuándo usarlo
- Un cliente cancela un pedido y quieres devolverle el importe sin entrar en Stripe.
- Tu equipo de soporte aprueba un reembolso parcial por un producto dañado.
- Detectas un cobro duplicado y quieres devolver uno de ellos indicando el motivo.
- Quieres un informe de las devoluciones realizadas.
Configuración
Necesitas una credencial Stripe API con la clave secreta de tu cuenta de Stripe. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial Stripe API de tu cuenta. |
| Operation (obligatorio) | La acción que realiza el componente. Por defecto, Create. Consulta Operaciones. |
| Mode | Solo en Get. By ID consulta una devolución concreta; All devuelve la lista de devoluciones. Por defecto, By ID. |
| Refund ID | El identificador de la devolución en Stripe (empieza por re_). Obligatorio en Get con By ID y en Update. |
| Charge ID | Solo en Create, y obligatorio en ella. El cobro que se devuelve (empieza por ch_). |
| Amount | Solo en Create. El importe a devolver en la unidad más pequeña de la moneda, por ejemplo céntimos: 1500 son 15,00. Vacío, se devuelve el cobro completo. |
| Reason | Solo en Create. El motivo de la devolución: duplicate (cobro duplicado), fraudulent (fraude) o requested_by_customer (lo pide el cliente). Opcional. |
| Description | Solo en Update. Una nota que se guarda en la devolución. |
| Limit | Solo en Get con All. Número máximo de devoluciones que se devuelven, entre 1 y 100. Por defecto, 100. |
Operaciones
- Create: devuelve un cobro, completo o por el importe indicado.
- Get: con
By IDdevuelve una devolución; conAlldevuelve la lista de devoluciones. - Update: guarda una nota en una devolución existente.
Resultado
La salida Data devuelve la devolución creada, consultada o actualizada. Con Get y All, devuelve un elemento por cada devolución. Cada elemento incluye el identificador de la devolución, el cobro al que pertenece, el importe y su estado.
Puedes conectarla a un correo de confirmación para el cliente o a tu sistema de soporte para cerrar la incidencia. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo usarlo. Consulta Tool Mode.
Ejemplo
Una tienda online devuelve el importe cuando soporte aprueba una devolución.
- Cuando se aprueba la devolución en tu herramienta de soporte, el flujo recibe el identificador del cobro.
- Añade Stripe Refund con Operation en
Createy pasa el identificador a Charge ID. - Deja Amount vacío para devolver todo y pon Reason en
requested_by_customer. - Conecta la salida Data a un correo que confirme la devolución al cliente.
Buenas prácticas
- Antes de devolver, comprueba el cobro con Stripe Charge para no devolver dos veces el mismo importe.
- Si un agente usa este componente como herramienta, deja claro en sus instrucciones cuándo puede devolver dinero y hasta qué importe.
Componentes relacionados
- Stripe Charge: cobros de tu cuenta.
- Stripe Payment Intent: pagos con confirmación y captura.
- Stripe Invoice: facturas de tus clientes.