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

# Efectivo

> Cobra en efectivo en caja o en la puerta con @fire-spark/payments-cash.

El efectivo lo cobra el personal. El tender de efectivo se queda en `IDLE` hasta que la tienda lo marca como pagado.

| | |
| - | - |
| Países | Todos |
| Monedas | La moneda del pedido |
| Estado | Disponible |
| Paquete | `@fire-spark/payments-cash` |

## Requisitos

* Sin contrato con un proveedor, sin hardware y sin credenciales.
* Funciona en todos los canales (app, web, kiosco, call center). Solo JavaScript, sin módulo nativo.

## Activarlo

En el dashboard, abre tu merchant, entra a **Payments** y crea un pago con el proveedor **Fire spark** y el método **Cash**. Elige las tiendas y canales donde aplica. El efectivo no tiene campos de configuración ni campos de dispositivo.

## Usarlo en el SDK

```bash theme={null}
pnpm add @fire-spark/payments-cash
```

```typescript theme={null}
import { cashPayments } from "@fire-spark/payments-cash";

order.setPaymentAdapters([cashPayments()]);
order.setPaymentOptions({ cashCollectAt: "COUNTER" }); // "DOOR" en delivery

const result = await order.payIntent({ payment: cashPayment });
// result.status === "PENDING" mientras el tender de efectivo está IDLE
```

`payIntent({ payment })` coloca un tender real de efectivo. `collect_at` sale de `cashCollectAt` (`COUNTER` o `DOOR`). Para dividir el efectivo con otro método, llama `order.setTenders` con un allocation y luego `payIntent()`. Ver [Usar pagos en el SDK](https://firespark.cloud/docs/es/guides/payments/use-payments-in-the-sdk.md).

## Qué ve el cliente

El canal muestra su propio mensaje de "paga en caja" o "paga al recibir". El metadata del resultado del adaptador incluye `attempt_reference`. Los `details` de efectivo pueden guardar `tendered` y `change`. No hay voucher.

## Webhooks

No tiene.

## Errores frecuentes

| Código Spark | Código del proveedor | Qué hacer |
| - | - | - |
| `CANCELLED_BY_USER` | — | El cliente canceló antes de colocar. No se cobró nada. |

## Compatibilidad

| `@fire-spark/payments-cash` | Proveedor | `@fire-spark/payments` |
| - | - | - |
| 0.3.2 | Sin proveedor externo | 0.3.2 |


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