小程序调起签约api
更新时间:2024.11.14应用场景
商户可以通过请求此接口唤起小程序委托代扣的签约页面,页面样例见委托代扣模式。
用户在微信的页面中完成代扣签约后,微信会同时将签约信息通过异步通知的方式通知给商户后台。如果用户放弃签约或签约失败则不通知。
商户流程介绍
1.用户从商户小程序发起签约请求 (商户需确认委托代扣权限已开通,模板已审批通过,小程序APPID与商户号已绑定)
2.商户将签约请求参数按照规则拼接之后,通过小程序跳转,向签约小程序发起签约请求
3.用户在微信签约小程序选择支付方式完成签约
4.微信将签约结果返回给商户
接口调用请求说明
接口 | wx.navigateToMiniProgram(OBJECT)接口 |
说明 | iOS 微信客户端 6.5.9 版本开始支持,Android 客户端即将在 6.5.10 版本开始支持 |
OBJECT参数说明:
字段含义 | 变量名 | 必填 | 示例值 | 类型 | 描述 | |||
---|---|---|---|---|---|---|---|---|
微信签约小程序appid | appId | 是 | wxbd687630cd02ce1d | String | 固定值 请在小程序配置文件app.json的配置项navigateToMiniProgramAppIdList中增加此appid | |||
场景信息传递给小程序的数据 | extraData | 是 | {"appid":"wx0317c726bd1c1111","mch_id":"1900000000","notify_url":"https://www.qq.com/a.php","contract_code":"2017121216136aa","contract_display_account":"张三","plan_id":"72803","request_serial":"1000","timestamp":"1513065696","sign":"63EE946A87EE1C8F6C12C1DB085C8B7E"} | object | 签约的请求参数,详情见extraData字段详细说明 | |||
| ||||||||
打开小程序的页面路径 | path | 是 | pages/index/index | string | 固定值:pages/index/index | |||
接口调用成功的回调函数 | success | 是 |
| Function |
| |||
接口调用失败的回调函数 | fail | 是 |
| Function |
| |||
接口调用结束的回调函数 | complete | 是 |
| Function | 调用成功、失败都会执行 |
示例:
用户签约完成之后,会跳转回商户小程序,可通过onShow(OBJECT)所携带的参数判断判断用户由签约小程序返回商户小程序,OBJECT返回参数请查看小程序开发文档onShow参数说明
referrerInfo.extraData字段说明
返回码 | 变量名 | 必填 | 示例值 | 类型 | 描述 |
---|---|---|---|---|---|
返回码 | return_code | 是 | SUCCESS | String | 客户端小程序收到的签约结果 SUCCESS:签约成功 FAIL:签约失败 |
错误信息 | return_msg | 是 |
| String | 签约失败的错误信息 |
委托代扣协议id | contract_id | 是 | 201710180325670965 | String | 签约成功后微信返回的委托代扣协议id |
注意:如果用户正常点击微信签约页的确定按钮返回商户小程序,那么会返回extraData ; 如果用户点击浏览器左上角的返回,则不返回extraData
示例: