> ## 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.

# Anular tender

> Anula un tender que todavía no se cobró en un pedido colocado.

Anula un tender que todavía no está `PAID`, `CANCELLED` ni `REFUNDED`. La llamada es idempotente por `idempotency_key`. Un tender pagado se reembolsa.

> [!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.voidTender(tenderId, 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. Reúsalo para reintentar la misma anulación. |
| `reason` | No | Hasta 500 caracteres |

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

## Respuesta

Devuelve `200` con el pedido. El estado del tender queda `CANCELLED` cuando el proveedor acepta la anulación. Un resultado `NEEDS_REVIEW` igual anula el tender 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 ya está pagado, anulado o reembolsado |
| `502` | El proveedor rechazó la anulación |


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