签约-小程序

mchid 　必填 string(32)

【商户号】 平台商户号

appid 必填 string(32)

【小程序 AppID】 调用方小程序的 AppID，必须与申请权限时提供的 AppID 一致

package 必填 string(256)

【权限申请扩展字符串】需拼接用户标志 openid、权限类型 permissionType参数格式：openid=oZMw85eFXXGIa9IZwGdH9TF_lTPw&permissionType=INDIVIDUAL_PAYEE，目前 permissionType 仅支持 INDIVIDUAL_PAYEE

timeStamp 必填 string(32)

【签名时间戳】 签名时的系统时间戳，自格林威治时间 1970-01-01 00:00:00（北京时间 1970-01-01 08:00:00）至现在的总秒数。
注意： 部分系统取到的值为毫秒级，需要转换成秒（10位数字）。

nonceStr 必填 string(32)

【随机字符串】 签名使用的随机字符串，不超过 32 字节

signType 必填 string(32)

【签名类型】默认为 RSA，仅支持 RSA

certSerialNo 必填 string(64)

【证书序列号】签名使用的商户 API 证书序列号

signature 必填 string(512)

【签名值】使用字段 appid timeStamp nonceStr package 计算得出的签名值，具体算法见下文签名步骤。

签名所使用的 appid 为申请个人签约小程序时的 appid，微信支付会校验当前小程序与申请的 AppID 是否一致。

小程序调起签约示例

1import WechatPayIndividualContracts from "@tenpay/wechatpay-miniprogram-individual-contracts";
2
3WechatPayIndividualContracts.requestSign({
4  mchid: '1900000000',
5  appid: 'wx8888888888888888',
6  package: 'openid=oZMw85eFXXGIa9IZwGdH9TF_lTPw&permissionType=INDIVIDUAL_PAYEE',
7  timeStamp: '1414561699',
8  nonceStr: '5K8264ILTKCH16CQ2502SI8ZNMTM67VS',
9  signType: 'RSA',
10  certSerialNo: 'ABCDEFG0123456789',
11  signature: 'oR9d8PuhnIc+YZ8cBHFCwfgp...',
12  success: function (res) {
13    // 已确认收款, 结算结果以服务端回调为准
14  },
15  fail: function (err) {
16    // 确认收款失败, 详见: `err.code` `err.message`
17  },
18  complete: function () {
19    // 无论成功/失败均会回调
20  },
21});

individualAuthId 必填 string(64)

【授权id】表示一个【微信支付用户账号id】与一个【商户】的授权关系

authState 必填 string(64)

【授权状态】授权的结果状态， 值为AUTHORIZED 已授权 或 UNAUTHORIZED 未授权

operationTime 必填 string(64)

【操作时间】遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）。例如：2015-05-20T13:29:35+08:00表示，北京时间2015年5月20日13点29分35秒。

成功回调的参数示例

1{
2  individualAuthId: "1236698745558870",
3  authState: "AAA12345678",
4  operationTime: "2024-05-20T13:29:35+08:00",
5}

code 必填 string(32)

【错误码】详见错误码部分

message 必填 string(1024)

【失败原因】不建议展示给用户，仅用于商户的开发人员定位失败原因

失败回调的参数示例

1{
2  code: "PARAM_ERROR",
3  message: "timeStamp 格式有误"
4}