APP签约
更新时间:2025.03.21用户在商户的APP中发起签约,跳转到微信客户端签约小程序完成签约,签约完成后重新打开商户APP。 移动应用(APP)接入开放平台SDK后,用户即可以在 APP 中跳转至微信某一小程序的指定页面,完成服务后再跳回至商户APP。
|
步骤1:预签约API
1. 接口说明
适用对象: 直连模式 机构模式
请求URL:https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/app-pre-entrust-sign
请求方式:POST
Path 指该参数为路径参数
Query 指该参数为URL参数
Body 指该参数需在请求JSON传参
2. 请求参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
应用ID | appid | string[1, 32] | 是 | Body 商户号绑定的AppID |
子商户号 | sub_mchid | string[1, 32] | 是 | Body 微信支付分配的子商户号 |
服务商应用ID | sp_appid | string[1, 32] | 是 | Body 服务商绑定的AppID |
子商户应用ID | sub_appid | string[1, 32] | 否 | Body 发起签约的子商户号绑定的AppID |
模板ID | plan_id | int | 是 | Body 协议模板ID,该模板ID是商户在向微信支付提交代扣权限申请时由微信支付生成 |
商户侧签约协议号 | out_contract_code | string[1, 32] | 是 | Body 商户请求签约时传入的签约协议号,商户侧须唯一 |
用户账户展示名称 | user_display_name | string[1, 32] | 是 | Body 签约用户的名称,用于页面展示,不需要对值进行URL编码,参数值不支持UTF8非3字节编码的字符,例如表情符号,所以请勿传微信昵称到该字段 |
签约成功通知URL | success_notify_url | string[1, 256] | 是 | Body HTTPS开头的回调通知URL ,不需要对值进行URL编码 |
商户AppID下的用户标识 | openid | string[1, 128] | 否 | Body 用户在商户AppID下的OpenID,服务商模式为子商户下的用户OpenID,可详见获取openid |
用户客户端IP | user_client_ip | string[1, 32] | 否 | Body 该字段要求填入用户客户端的IP,用户签约时会校验用户客户端IP与商户传的用户客户端IP一致,若不一致则视为商户引导的用户和实际访问用户不一致,会拒绝该签约请求。 |
过期时间 | expired_time | string[1, 64] | 否 | Body 境外代扣签约会话ID过期时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2021-11-20T13:29:35+08:00表示,北京时间2021年11月20日 13点29分35秒。 |
请求示例
场景一:直连模式
场景二:服务商模式/机构模式
3. 返回参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
委托代扣签约会话ID | session_id | string[1,128] | 是 | 微信返回的委托代扣签约会话ID |
返回示例
正常示例
4. 错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
403 | CONTRACT_EXISTED | 已开通自动扣费服务功能,无需重复开通 | 已开通自动扣费服务功能,无需重复开通;如需重新签约,需解约后再发起签约 |
400 | PARAM_ERROR | 参数错误 | 传入正确查询参数 |
500 | SYSTEM_ERROR | 系统错误 | 请稍等重试 |
步骤2:签约接口
时序图
简介
App跳转微信侧小程序需要引用新的openSDK
Android openSDK下载地址(版本>=5.3.1):Android资源下载
Android 接入文档链接:openSDK说明文档/
iOS openSDK下载地址(版本>=1.8.4):iOS资源下载
iOS 接入文档链接:openSDK说明文档
接口名称:WXOpenBusinessView
接口兼容:
● iOS兼容性表现:若微信版本 >= 7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本 < 7.0.3,开发者通过此openSDK接口可以跳转到微信,但不能跳转到微信支付分小程序,此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
● Android兼容性表现:若微信版本>=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本 < 7.0.3,开发者通过此openSDK接口不能跳转到微信,此时开发者应提示用户更新微信版本。
请求参数
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
跳转类型 | businessType | string[1, 32] | 是 | 固定值:wxpayOverseaEntrustAuthorization |
委托代扣签约会话ID | sessionId | string[1, 128] | 是 | 预签约API中的返回值 session_id,由 APP 预签约接口获得 |
请求示例
场景一:IOS
场景二:Android