客户自建收银台

更新： 2026-09-18 状态： 已发布基础合同；支付方式发现暂不提供对客 OpenAPI

自建收银台可根据统一 CheckoutAction 控制前端体验，但不得绕过商户签约能力、应用授权和平台路由。

接入流程

1. 在商户工作台查看已开通的支付产品和场景。当前未发布独立的“可用支付方式查询”对客 API。
2. 商户服务端创建支付会话，按用户终端选择 MINI_PROGRAM、APP、H5、PC 或 QRCODE。
3. 读取响应的统一动作：

type CheckoutAction = {
  type:
    | "MINI_PROGRAM_LAUNCH"
    | "APP_H5"
    | "H5_URL"
    | "PC_H5"
    | "QRCODE_URL";
  payload: Record<string, string>;
  expiresAt: string;
};

4. 前端必须对未知 type 做安全降级，不猜测或硬编码上游通道参数。
5. 所有前端回调只进入“正在确认”，最终状态由商户服务端查询或 Webhook 确认。

约束

• channelCode 只能使用当前商户已绑定且允许的通道；不传时由平台路由。
• 客户不能指定平台内部通道账户或读取上游密钥。
• 自建页不得采集银行卡号、网银密码、支付密码等敏感支付凭据。
• 对外契约以生成的 OpenAPI 文档为准；未出现在 OpenAPI 中的路径不可调用。