跳到主要内容

接口开放状态

接口范围更新:2026-11-20;执行支持更新:2026-11-20。请依据下列状态选择接入路径,再确认目标环境是否启用相应能力及账户权限。

标记含义
商户路由已确认方法与路径已纳入商户 API 范围;使用前确认目标环境和账户权限。
执行支持待确认已有接口入口,但所需资金操作尚待确认,暂不纳入上线依赖。
开放待确认已有接口约定,商户访问尚待确认;用于提前设计和开通沟通。

当前收款确认使用服务端查询 Checkout。Webhook 通知与退款仍待确认。创建归集需单独确认执行能力;能查询归集资源或存在开放路由,不代表资金归集已经可执行。

操作方法与路径状态
查询收款方式GET /v1/payment-methods商户路由已确认
创建 CheckoutPOST /v1/checkouts商户路由已确认
查询 CheckoutGET /v1/checkouts/{id}商户路由已确认
列出 CheckoutGET /v1/checkouts商户路由已确认
关闭 CheckoutPOST /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 开通时须一并确认签名头、原始请求体验签和投递重试规则,不自动兼容不同签名头。接口开放确认应覆盖认证、错误格式、幂等、事件验签及完整业务生命周期。