> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman 集合

> 使用 Postman 集合快速测试 Waffo API。

Postman 集合为所有 Waffo API 提供预配置的请求，便于快速运行测试。

## 如何获取

下载 Sandbox 环境的 Postman Collection JSON 文件：

<a href="/docs/files/developer-docs/postman/Waffo-acquiring-api-demo-sandbox-onetimepayment.postman_collection.json" download="Waffo-acquiring-api-demo-sandbox-onetimepayment.postman_collection.json">下载 Postman Collection</a>

如果浏览器仍然打开预览，请右键链接选择另存为，并保留 `.postman_collection.json` 文件名。

## 如何导入

<Steps>
  <Step title="打开 Postman">
    在 Postman 中，选择 **Import → Upload Files**。
  </Step>

  <Step title="上传文件">
    选择已下载的 Collection JSON 文件。
  </Step>

  <Step title="配置环境变量">
    配置以下环境变量。
  </Step>
</Steps>

## 环境变量

| 变量            | 描述                                 | 示例值                             |
| ------------- | ---------------------------------- | ------------------------------- |
| `base_url`    | API 基础 URL                         | `https://api-sandbox.waffo.com` |
| `api_key`     | API Key                            | 从 Dashboard 获取                  |
| `merchant_id` | 商户 ID                              | `M000001`                       |
| `signature`   | 请求 body 的 SHA256WithRSA 签名（Base64） | 发送请求前生成                         |

## 包含的端点

| 端点       | 路径                                         |
| -------- | ------------------------------------------ |
| 创建支付     | `POST /api/v1/order/create`                |
| 查询支付     | `POST /api/v1/order/inquiry`               |
| 取消订单     | `POST /api/v1/order/cancel`                |
| 发起退款     | `POST /api/v1/order/refund`                |
| 查询退款     | `POST /api/v1/refund/inquiry`              |
| 创建订阅     | `POST /api/v1/subscription/create`         |
| 查询订阅     | `POST /api/v1/subscription/inquiry`        |
| 取消订阅     | `POST /api/v1/subscription/cancel`         |
| 更新订阅     | `POST /api/v1/subscription/change`         |
| 查询更新     | `POST /api/v1/subscription/change/inquiry` |
| 订阅管理     | `POST /api/v1/subscription/manage`         |
| 商户配置查询   | `POST /api/v1/merchantconfig/inquiry`      |
| 支付方式配置查询 | `POST /api/v1/paymethodconfig/inquiry`     |

## 签名配置

Collection 已预置 `X-SIGNATURE: {{signature}}` Header。发送请求前，请使用商户私钥对 raw JSON body 做 SHA256WithRSA 签名，并将 Base64 签名结果填入 `signature` 变量。

如果修改请求 body，需要重新生成签名。不要将生产私钥保存到 Postman Collection 文件中。