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

# Merchant API

> 使用服务端 Merchant API 密钥读取订单、产品和客户记录。

Merchant API 是面向商户后端、稳定且按组织隔离的交易 API。各端点页面直接根据公开的 OpenAPI 契约渲染，因此请求参数和响应数据结构会与实际服务保持一致。

<Note>
  路径、参数、字段和状态码以生成的端点页面为准。本指南只解释如何使用 API，不再重复维护契约内容。
</Note>

## 浏览 API

<CardGroup cols={2}>
  <Card title="API 密钥信息" icon="key" href="/zh/api-reference/endpoint/api-keys">
    查看当前请求对应的组织和密钥。
  </Card>

  <Card title="订单" icon="receipt" href="/zh/api-reference/orders-guide">
    确认付款状态并构建幂等履约。
  </Card>

  <Card title="目录与访问权限" icon="boxes-stacked" href="/zh/api-reference/catalog">
    访问产品、订阅、客户和访问权益。
  </Card>

  <Card title="生成的数据结构" icon="brackets-curly" href="/zh/api-reference/endpoint/orders">
    查看准确的查询参数、响应字段和错误。
  </Card>
</CardGroup>

## 通用规则

* 公开 Merchant API 使用服务端 `X-API-Key`。
* 每个请求都限制在该密钥所属的组织内。
* 成功响应使用统一的响应结构；列表操作返回分页数据。
* 缺少密钥或密钥无效时，请求会在解析组织数据前被拒绝。

<Warning>
  不要在浏览器代码、移动应用、公开仓库或客户可见 URL 中暴露 Merchant API 密钥。
</Warning>