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

# Reemplazar tender

> Cambia un tender fallido por un método nuevo en un pedido colocado.

Agrega un tender nuevo con `replaces_tender_id` apuntando a un tender real `FAILED`. El reemplazo se valida con las mismas reglas que el intent original. Vuelve a cobrarlo con `order.payIntent()`.

> [!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 y el intent debe estar `LOCKED`.

En `@fire-spark/storefront`, llama `order.replaceTender(tenderId, payment, collectAt)`.

## Parámetros de ruta

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

## Cuerpo de la solicitud

| Campo | Requerido | Descripción |
| - | - | - |
| `method` | Sí | Método de reemplazo |
| `payment_id` | Sí | Id del pago del merchant |
| `provider` | Sí | Id de proveedor del catálogo |
| `collect_at` | Sí | `DEVICE`, `KIOSK`, `COUNTER`, `DOOR` u `OTHER` |

```bash theme={null}
curl -X POST "https://firespark.cloud/api/storefront/v1/orders/ord-48291/tenders/tnd-card-1/replace" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "CASH",
    "payment_id": "3b1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
    "provider": "firespark",
    "collect_at": "COUNTER"
  }'
```

## Respuesta

Devuelve `200` con el pedido. El tender nuevo queda en el intent bloqueado.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `404` | Pedido o tender vivo no encontrado |
| `409` | El tender no está `FAILED`, o el pedido sigue `OPEN` (`details.code: PAYMENT_INTENT_LOCKED`) |
| `422` | El reemplazo no pasa las mismas validaciones que [Guardar intent de pago](https://firespark.cloud/docs/es/storefront-api/orders/\[id]/payment-intent/put) |


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