---
name: shortpay-data-reading
description: Use when reading approved ShortPay Stripe-compatible account, charge, event, payment intent, or refund data without initiating a payment action.
---

# ShortPay 公共数据读取

公开文档不需要密钥，但读取业务数据仍需要单站点 Bearer 服务端密钥。当前协议和参数以 `/v1/docs?format=markdown` 为准。

## 允许的读取

- `GET /v1/account`：当前站点稳定 account ID；能力 flags 为未知。
- `GET /v1/charges`：已确认付款的最新优先列表，支持 `limit`、`starting_after`、`ending_before` 与 `created` 时间过滤。
- `GET /v1/events`：不可变的 `charge.succeeded` 快照，支持与 charges 相同的游标/时间过滤及单一 `types[]=charge.succeeded`。
- `GET /v1/customers/{id}`、`/v1/checkout/sessions/{id}`、`/v1/checkout/sessions/{id}/line_items`、`/v1/payment_intents/{id}`、`/v1/refunds/{id}`：读取已知且属于本站点的对象。

## 约束

- 不要寻找、复制、揭示或自动轮换密钥；缺少经过批准的服务端密钥时停止。
- 不调用 POST 端点、托管 checkout capability 路径或管理 API 来完成一次“读取”任务。
- 金额一律以整数最小单位和货币一起报告，避免浮点计算。
- `processing`、`pending`、`unknown` 与未确认退款不应被表述为已完成。Charge 是支付确认，不是结算或银行对账证据。
- 游标、对象 ID 和返回数据按站点隔离。404/400 不是尝试其他站点或其他凭据的理由。
- 输出中最小化个人信息、买家 capability URL 和标识符；不要把原始业务数据公开传播。