小程序支付

更新： 2026-09-18 状态： 统一接口已发布；生产拉起能力按商户已开通的支付产品确定

接入流程

1. 小程序向商户服务端提交订单，金额由服务端重新计算。
2. 商户服务端调用 POST /open/v1/checkout-sessions，scene 传 MINI_PROGRAM，并在 wechatPayer 中传入当前付款人的 openId 及归属范围。
3. 成功响应的 action.type 为 MINI_PROGRAM_LAUNCH，拉起参数位于 action.payload，具体键值由当前已签约支付产品返回。
4. 小程序按对应支付产品的官方要求拉起支付。
5. 前端返回仅表示拉起流程结束；最终结果以商户服务端查询或 Webhook 为准。

前置条件

• 商户、应用与小程序支付能力均已审核并启用。
• 小程序 AppID、主体关系、半屏或全屏拉起权限符合上游产品当前规则。
• 沙箱与生产使用独立凭据，不共用上游密钥。
• scope: DIRECT 用于直连商户 AppID 下的 openId；scope: SUB_MERCHANT 用于服务商子商户 AppID 下的 openId。两者不得混用。
• wechatPayer 与普通业务 metadata 隔离存储，不会在收银台响应或 Webhook 中返回。

{
  "scene": "MINI_PROGRAM",
  "wechatPayer": {
    "openId": "oSmartPayPayer123",
    "scope": "SUB_MERCHANT"
  }
}

SmartPay 目前对外发布统一 CheckoutAction，未发布独立的小程序组件包。