# billing

> Shoplazza CLI billing commands for charging merchants from a Shoplazza App: one-time charges, recurring subscriptions, usage records, and transaction lookups.

Manage app billing — one-time charges, recurring subscriptions, transactions, and usage billing. 14 API commands.

All billing commands share these flags:

| Flag | Short | Description |
|------|-------|-------------|
| `--params` | | Path/query parameters as JSON |
| `--data` | | Request body as JSON (inline, `@file`, or `-` for stdin); only on commands that take a request body |
| `--jq` | `-q` | jq expression to filter output |
| `--dry-run` | | Preview the request without executing |

## one-time

Manage one-time charges for your app.

```shell
shoplazza billing one-time create --data @charge.json
shoplazza billing one-time get --params '{"charge_id":"123"}'
shoplazza billing one-time list
shoplazza billing one-time transactions --params '{"charge_id":"123"}'
```

## recurring

Manage recurring subscriptions.

```shell
shoplazza billing recurring create --data @subscription.json
shoplazza billing recurring get --params '{"charge_id":"123"}'
shoplazza billing recurring list
shoplazza billing recurring update --params '{"charge_id":"123"}' --data '{"capped_amount":100}'
shoplazza billing recurring cancel --params '{"charge_id":"123"}'
shoplazza billing recurring transactions --params '{"charge_id":"123"}'
```

## transactions

Query individual transactions.

```shell
shoplazza billing transactions get --params '{"transaction_id":"123"}'
```

## usage

Manage usage-based billing records.

```shell
shoplazza billing usage create --params '{"charge_id":"123"}' --data @usage.json
shoplazza billing usage get --params '{"charge_id":"123","usage_charge_id":"456"}'
shoplazza billing usage list --params '{"charge_id":"123"}'
```

## Related

* [Subscription billing guide](/docs/app/building-blocks/billing/overview) — Integration guide and API flow