# 计费

> Shoplazza AI Toolkit 中 shoplazza-billing 技能的自然语言指令示例：一次性收费、订阅收费、用量收费、查交易流水与取消订阅。

`shoplazza-billing` 技能的自然语言指令——为你的应用向商家收费。每条请求前加 `/shoplazza-billing` 前缀，再描述任务。

## 前置条件

* [快速开始](../get-started)
* 按[快速开始](../get-started#3-认证)对店铺完成认证。应用收费命令本身不需要 OAuth scope（`--domain billing` 不会展开出任何 scope），所以只带 `--domain billing` 的店铺登录会因没有请求任何 scope 而被拒绝。

## 示例

### 1. 创建一次性收费

```
/shoplazza-billing 创建一笔 49 美元的一次性收费,用于 Pro 版初始化
```

运行 `billing one-time create`。作为写操作，智能体会先 `--dry-run` 预览并确认。

### 2. 创建订阅（周期性）收费

```
/shoplazza-billing 给这个商家开一个每月 19 美元的订阅
```

运行 `billing recurring create`。

### 3. 记录用量计费

```
/shoplazza-billing 在订阅 123 上记 1000 次 API 调用的用量费
```

对该订阅运行 `billing usage create`。

### 4. 查订阅的交易流水

```
/shoplazza-billing 看下订阅 123 的交易记录
```

运行 `billing recurring transactions --params '{"charge_id":"123"}'`。

### 5. 取消订阅

```
/shoplazza-billing 取消订阅 123
```

运行 `billing recurring cancel`。智能体会先预览并确认再取消。

## 域边界

本技能负责**应用收费**（为你的应用向商家收费）。**买家**的订单支付与退款属于 [`/shoplazza-orders`](./orders)，不在计费。

## 参见

* [Shoplazza CLI:billing 命令](/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/billing)
* [订阅计费指南](/zh-CN/docs/app/building-blocks/billing/overview)