# 计费

> Shoplazza CLI 的 billing 命令，用于 Shoplazza 应用向商家收费：一次性收费、周期性订阅、用量记录与交易查询。

管理应用计费——一次性收费、周期性订阅、交易和用量计费。14 个 API 命令。

所有 billing 命令共享以下参数：

| 参数 | 短参 | 说明 |
|------|------|------|
| `--params` | | 路径/查询参数（JSON 格式） |
| `--data` | | 请求体（JSON 格式，可内联、`@file` 或 `-` 读取 stdin）；仅在需要请求体的命令上提供 |
| `--jq` | `-q` | jq 表达式过滤输出 |
| `--dry-run` | | 预览请求，不实际执行 |

## one-time

一次性收费管理。

```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

周期性订阅管理。

```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

查询单笔交易。

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

## usage

用量计费管理。

```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"}'
```

## 相关

* [订阅计费指南](/zh-CN/docs/app/building-blocks/billing/overview)