> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Reembolsar tender

> Reembolsa un tender pagado completo, por monto o por unidades.

Reembolsa un tender `PAID` que todavía tiene dinero pendiente. Omite `amount` e `items` para un reembolso completo. Envía `amount` o `items`, no ambos. La llamada es idempotente por `idempotency_key`.

> [!NOTE]
>
> Requiere un access token de Storefront API de [Intercambio de
> token](https://firespark.cloud/docs/es/storefront-api/oauth/exchange/post.md). El pedido ya debe estar
> colocado.

En `@fire-spark/storefront`, llama `order.refundTender(tenderId, { amount, reason })`.

## Parámetros de ruta

| Parámetro | Requerido | Descripción |
| - | - | - |
| `id` | Sí | Identificador externo del pedido |
| `tenderId` | Sí | Identificador del tender |

## Cuerpo de la solicitud

| Campo | Requerido | Descripción |
| - | - | - |
| `idempotency_key` | Sí | 10–64 caracteres |
| `amount` | No | Reembolso parcial, mayor que 0 |
| `items` | No | `[{ line_uid, units? }]`. No lo envíes junto con `amount`. |
| `reason` | No | Hasta 500 caracteres |

```bash theme={null}
curl -X POST "https://firespark.cloud/api/storefront/v1/orders/ord-48291/tenders/tnd-card-1/refund" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "idempotency_key": "refund-9f3c1a20b4", "amount": 4.5 }'
```

## Respuesta

Devuelve `200` con el pedido. `refunded_total` del tender sube por el monto reembolsado. Un reembolso completo deja el tender en `REFUNDED`. Un resultado `NEEDS_REVIEW` igual aplica el reembolso y deja el caso para revisión. Un rechazo devuelve `502` y no cambia el tender.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `404` | Pedido o tender no encontrado |
| `409` | El pedido sigue `OPEN`, o el tender no está pagado con dinero pendiente |
| `422` | Se enviaron `amount` e `items` a la vez |
| `502` | El proveedor rechazó el reembolso |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.