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

# Datafono

> Cobra con un datáfono no integrado y marca el pago, como efectivo, con @fire-spark/payments-cash.

El datáfono es un terminal de tarjeta que Fire spark no controla. El personal cobra en el terminal y marca la orden como pagada. Funciona igual que el efectivo: el tender 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

* Un datáfono de tu banco o adquirente. Fire spark no se conecta a él: sin credenciales ni campos de dispositivo.
* Funciona en app, web, call center y POS. El kiosco no lo ofrece: ahí se paga en efectivo en caja.
* Fire spark no registra cuotas, propina, marca ni últimos 4 dígitos. Eso lo define el datáfono.

## Activarlo

En el dashboard, abre tu merchant, entra a **Payments** y crea un pago con el proveedor **Fire spark** y el método **PIN pad** (*Datafono*). Elige las tiendas y canales donde aplica. No tiene campos de configuración.

## Usarlo en el SDK

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

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

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

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

`collect_at` sale de `cashCollectAt`, igual que el efectivo. Si colocas la orden sin el SDK con `type: "PIN_PAD"` y `provider: "firespark"`, la API usa `DOOR` por defecto. En POS la venta queda `PAID` al registrarla y el código de aprobación, si lo escribes, queda como `provider_reference`.

## Qué ve el cliente

El canal muestra su propio mensaje de "paga con tarjeta al recibir" o "en caja". El metadata del resultado del adaptador incluye `attempt_reference`. No hay `details` ni voucher de Fire spark.

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

Un rechazo del datáfono no llega a Fire spark: reintenta en el terminal o cambia el método.

## Compatibilidad

| `@fire-spark/payments-cash` | Proveedor | `@fire-spark/payments` |
| - | - | - |
| Después de 0.9.1 | Sin proveedor externo | La misma versión |


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