Cash

Cash is collected by staff. The cash tender stays IDLE until the store marks it paid.


Countries	All
Currencies	The order currency
Status	Available
Package	`@fire-spark/payments-cash`

Requirements

No provider contract, hardware, or credentials.
Works in every channel (app, web, kiosk, call center). JavaScript only, no native module.

Activate it

In the dashboard, open your merchant, go to Payments, and create a payment with the provider Fire spark and the method Cash. Choose the stores and channels where it applies. Cash has no configuration fields and no device fields.

Use it in the SDK

pnpm add @fire-spark/payments-cash

import { cashPayments } from "@fire-spark/payments-cash";

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

const result = await order.payIntent({ payment: cashPayment });
// result.status === "PENDING" while the cash tender is IDLE

payIntent({ payment }) places one real cash tender. collect_at comes from cashCollectAt (COUNTER or DOOR). To split cash with another method, call order.setTenders with an allocation and then payIntent(). See Use payments in the SDK.

What the customer sees

The channel shows its own “pay at the counter” or “pay on delivery” message. The adapter result metadata includes attempt_reference. Cash details can record tendered and change. There is no voucher.

Webhooks

None.

Common errors

Spark code	Provider code	What to do
`CANCELLED_BY_USER`	—	The customer cancelled before placing. Nothing was charged.

Compatibility

`@fire-spark/payments-cash`	Provider	`@fire-spark/payments`
0.3.2	No external provider	0.3.2

Get Started

Integrations

Guides

Use cases

Requirements

Activate it

Use it in the SDK

What the customer sees

Webhooks

Common errors

Compatibility

​Requirements

​Activate it

​Use it in the SDK

​What the customer sees

​Webhooks

​Common errors

​Compatibility

Requirements

Activate it

Use it in the SDK

What the customer sees

Webhooks

Common errors

Compatibility