1. 接口说明

通过“统一下单接口”获取到发起支付的必要参数信息，然后商户小程序使用微信支付官方提供的方法调起小程序门店助手支付

小程序接口：wx.requestCommonPayment(Object object)

注意：基础库3.8.6版本后支持（说明：由于该接口仍未向旧版本基础库进行覆盖，因此对接期间，请使用该版本进行开发。待开发验证无问题后，平台将进行旧版本基础库覆盖，此时方可正式对外使用）

2. 请求参数

属性 类型[长度限制] 必填 描述
signData Object 是 具体支付参数，详见signData，该参数以string传递
mode string 是 支付类型，固定值：retail_pay_indirect_goods
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

1） signData参数

属性 类型[长度限制] 必填 描述
requestPaymentInfo Object 是 支付信息，微信支付参数，格式详见requestPaymentInfo

2） requestPaymentInfo参数

属性 类型[长度限制] 必填 描述
timeStamp string 是 时间戳，从1970年1月1日 00:00:00 至今的秒数，即当前的时间
nonceStr string 是 随机字符串，长度为32个字符以下
package string 是 统一下单接口返回的wc_pay_data内prepay_id参数值，提交格式如：prepay_id=****
signType string 否 签名算法，取统一下单接口返回的wc_pay_data内的同名字段
paySign string 是 签名，取统一下单交接口返回的wc_pay_data内的同名字段

请求示例

    const signDataObj = {
      requestPaymentInfo: {
        timeStamp: "1747019232",
        nonceStr: "120899265cce4c39b95e4f31dff5ddc2",
        package: "prepay_id=wx12110712204599f3186256a53fbfa90001",
        signType: "RSA",
        paySign:
"hqMkkLJr4wXqIoPfM5M2JLC51pFWRXSMwXwT0jsDxND+Jch7NNKylc8RC/JTyh+bYe5ALbm0Zru9bDeeGWFGvnRxtfWJ7K73LZ6RsvgVij7dE1uZNNtkjtYXqOTSXQAL5DsnQkZkru01XGqQbAFIda5qsUR3jc4Bx5D9bT4M6ogIrNlWbijkOybsoNn099IQAQbdtbO+HmGgkDAW07SdL1BLr7glyZVI0c2tuD+ssaM0PmHbCJq7M3v5gj8VX2GtGQEj85j67ZWAwtJTSoLbiT/y9Zy/xTLN9RxZ/WZ4hM1I21syfuLGKNw8azc08+LE2YgOGyUlWaQnQmFDxwwYfA==",
      },
    };

    console.log("\n\n\n\n\n请求参数");
    console.log(signDataObj);
    // @ts-expect-error
    wx.requestCommonPayment({
      signData: JSON.stringify(signDataObj),
      mode: "retail_pay_indirect_goods",
      success: (res: any) => {
      },
      fail: (e: any) => {
      },
    });

3.返回参数

object.success 回调函数

属性 类型 说明
errMsg string 调用成功信息

object.fail 回调函数

属性 类型 说明
errMsg string 错误信息
errCode number 错误码

错误码

错误码 说明
1000 系统错误
702009 B2b授权关系校验不通过
作者：lilizhi  创建时间：2025-08-19 17:26
最后编辑：lilizhi  更新时间：2025-08-25 09:37