快速开始

对接前置

1. 向平台申请开通开放 API，并获取 API 密钥（仅下发一次明文，请妥善保管）。
2. 确认平台已告知你的 收银台 Base URL（文档中的 {BASE_URL}）。
3. 准备可接收 HTTPS POST 的 Webhook 地址（推荐），用于接收支付结果；也可仅用查询接口轮询。
4. 若需客户支付后回到你的站点，准备一个 HTTPS 回跳地址（return_url）。

密钥安全

API 密钥仅用于服务端调用，禁止写入前端、App、公开仓库或客户端配置。

---

推荐对接流程

1. POST /api/v1/open/charges  创建收款单
2. 将返回的 payment_url 展示给客户完成支付
3. 同时：
   - 接收 Webhook（PAID / FAILED …），或
   - 轮询 GET /api/v1/open/charges/{orderId}
4. （可选）客户浏览器经 return_url 回到你的站点

---

幂等建议

创建收款单时建议携带请求头 Idempotency-Key（如 UUID）。同一商户下相同幂等键的重复请求，将返回首次建单结果，避免网络重试导致重复下单。