接口开放状态
接口范围更新:2026-11-20;执行支持更新:2026-11-20。请依据下列状态选择接入路径,再确认目标环境是否启用相应能力及账户权限。
| 标记 | 含义 |
|---|---|
| 商户路由已确认 | 方法与路径已纳入商户 API 范围;使用前确认目标环境和账户权限。 |
| 执行支持待确认 | 已有接口入口,但所需资金操作尚待确认,暂不纳入上线依赖。 |
| 开放待确认 | 已有接口约定,商户访问尚待确认;用于提前设计和开通沟通。 |
当前收款确认使用服务端查询 Checkout。Webhook 通知与退款仍待确认。创建归集需单独确认执行能力;能查询归集资源或存在开放路由,不代表资金归集已经可执行。
| 操作 | 方法与路径 | 状态 |
|---|---|---|
| 查询收款方式 | GET /v1/payment-methods | 商户路由已确认 |
| 创建 Checkout | POST /v1/checkouts | 商户路由已确认 |
| 查询 Checkout | GET /v1/checkouts/{id} | 商户路由已确认 |
| 列出 Checkout | GET /v1/checkouts | 商户路由已确认 |
| 关闭 Checkout | POST /v1/checkouts/{id}/close | 商户路由已确认 |
| 查询付款明细 | GET /v1/checkouts/{id}/payments | 开放待确认 |
| 创建退款 | POST /v1/refunds | 开放待确认 |
| 查询退款 | GET /v1/refunds/{id} | 开放待确认 |
| 列出退款 | GET /v1/refunds | 开放待确认 |
| 取消退款 | POST /v1/refunds/{id}/cancel | 开放待确认 |
| 列出归集项 | GET /v1/settlement-items | 商户路由已确认 |
| 创建归集 | POST /v1/settlements | 执行支持待确认 |
| 查询归集 | GET /v1/settlements/{id} | 商户路由已确认 |
| 列出归集 | GET /v1/settlements | 商户路由已确认 |
| 创建通知端点 | POST /v1/webhook-endpoints | 开放待确认 |
| 列出通知端点 | GET /v1/webhook-endpoints | 开放待确认 |
| 更新通知端点 | PATCH /v1/webhook-endpoints/{id} | 开放待确认 |
| 删除通知端点 | DELETE /v1/webhook-endpoints/{id} | 开放待确认 |
Webhook 开通时须一并确认签名头、原始请求体验签和投递重试规则,不自动兼容不同签名头。接口开放确认应覆盖认证、错误格式、幂等、事件验签及完整业务生命周期。