预授权

最新更新时间:2022.06.09 版本说明


从业机构预授权

接口说明

适用对象:从业机构

请求URL:https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/permissions

请求方式:POST


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
服务ID service_id string[1, 32] body该服务ID有本接口对应产品的权限.
示例值:service_id
渠道商商户号 channel_id string[1, 32] body渠道商商户号
示例值:1230000109
从业机构的公众号ID appid string[1, 32] body微信公众平台分配的与传入的从业机构商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。
示例值:wxd678efh567hg6787
子商户的公众号ID sub_appid string[1, 32] body微信公众平台分配的与传入的子商户商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。
示例值:wxd678efh567hg6787
子商户商户号 sub_mchid string[1, 32] body子商户商户号
示例值:1230000109
授权协议号 authorization_code string[1, 32] body预授权成功时的授权协议号
示例值:1234323JKHDFE1243252
通知地址 notify_url string[1, 255] body授权成功回调通知地址
示例值:http://www.qq.com

请求示例


{
  "appid": "wxd678efh567hg6787",
  "authorization_code": "1234323JKHDFE1243252",
  "channel_id": "1230000109",
  "notify_url": "http://www.qq.com",
  "service_id": "service_id",
  "sub_appid": "wxd678efh567hg6787",
  "sub_mchid": "1230000109"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
预授权token apply_permissions_token string[1, 300] 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入
示例值:apply_permissions_token

返回示例


{
  "apply_permissions_token": "apply_permissions_token"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请确认相同单号是否使用了不同的参数
404 ORDER_NOT_ EXIST 订单不存在 确认入参,传入正确单据
400 INVALID_ORDER_STATE 单据状态错误 确认操作是否符合流程
400 ORDER_CANCELED 单据已取消 当前状态无需操作
400 ORDER_DONE 订单已完成 当前状态无需操作




查询与用户授权记录(授权协议号)

最新更新时间:2022.06.09 版本说明


从业机构通过调用该接口,使用authorization_code查询与用户授权关系

接口说明

适用对象:从业机构

请求URL:https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/permissions/authorization-code/{authorization_code}

请求方式:GET


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
服务ID service_id string[1, 32] query该服务ID有本接口对应产品的权限.
示例值:500001
授权协议号 authorization_code string[1, 32] path要求此参数只能由数字、大小写字母_-|*组成,且在同一个商户号下唯一。详见[商户订单号]。
示例值:1234323JKHDFE1243252
渠道商商户号 channel_id string[1, 32] query渠道商商户号
示例值:1230000109
子商户商户号 sub_mchid string[1, 32] query子商户商户号
示例值:1230000109

请求示例


https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/permissions/authorization-code/1234323JKHDFE1243252?service_id=500001&channel_id=1230000109&sub_mchid=1230000109

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
服务ID service_id string[1, 32] 该服务ID有本接口对应产品的权限。
示例值:2002000000000558128851361561536
公众号ID appid string[1, 32] 微信公众平台分配的与传入的商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。
示例值:wxd678efh567hg6787
商户号 mchid string[1, 32] 调用接口提交的商户号
示例值:1230000109
用户标识 openid string[1, 128] AppID下的用户标识
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
授权协议号 authorization_code string[1, 32] 预授权成功时的授权协议号
示例值:1275342195190894594
授权状态 authorization_state string[1, 16] 标识用户授权服务情况.
UNAVAILABLE: 用户未授权服务
AVAILABLE: 用户已授权服务
UNBINDUSER: 未绑定用户
示例值:UNAVAILABLE
授权通知地址 notify_url string[1, 255] 授权通知地址
示例值:https://www.weixin.com
最近一次解除授权时间 cancel_authorization_time string[1, 64] 最近一次解除授权时间,采用Rfc3339时间格式
示例值:2015-05-20T13:29:35+08:00
最近一次授权成功时间 authorization_success_time string[1, 64] 最近一次授权成功时间,采用Rfc3339时间格式
示例值:2015-05-20T13:29:35+08:00
子商户商户号 sub_mchid string[1, 32] 子商户商户号
示例值:1230000109
子商户的公众号ID sub_appid string[1, 32] 微信公众平台分配的与传入的子商户商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。
示例值:wxd678efh567hg6787
子商户的用户标识 sub_openid string[1, 128] 子商户的AppID下的用户标识
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
用户标签 user_label string[1,32] 用户标签,仅授权成功时返回(并且不保证一定返回) 枚举值:A、B、C(其中A>B>C)
示例值:A
渠道商商户号 channel_id string[1, 32] 渠道商商户号
示例值:1230000109

返回示例


{
  "appid": "wxd678efh567hg6787",
  "authorization_code": "1275342195190894594",
  "authorization_state": "UNAVAILABLE",
  "authorization_success_time": "2015-05-20T13:29:35+08:00",
  "cancel_authorization_time": "2015-05-20T13:29:35+08:00",
  "channel_id": "1230000109",
  "mchid": "1230000109",
  "notify_url": "https://www.weixin.com",
  "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "service_id": "2002000000000558128851361561536",
  "sub_appid": "wxd678efh567hg6787",
  "sub_mchid": "1230000109",
  "sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "user_label": "A"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请确认相同单号是否使用了不同的参数
404 ORDER_NOT_ EXIST 订单不存在 确认入参,传入正确单据
400 INVALID_ORDER_STATE 单据状态错误 确认操作是否符合流程
400 ORDER_CANCELED 单据已取消 当前状态无需操作
400 ORDER_DONE 订单已完成 当前状态无需操作




解除用户授权关系(授权协议号)

最新更新时间:2022.06.09 版本说明


从业机构通过调用该接口,使用authorization_code解除用户授权关系

接口说明

适用对象:从业机构

请求URL:https://api.mch.weixin.qq.com/v3/payscore/acquiringbank/permissions/authorization-code/{authorization_code}/terminate

请求方式:POST


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
授权协议号 authorization_code string[1, 32] path预授权成功时的授权协议号
示例值:1234323JKHDFE1243252
服务ID service_id string[1, 32] body该服务ID有本接口对应产品的权限.
示例值:500001
渠道商商户号 channel_id string[1, 32] body渠道商商户号
示例值:1230000109
子商户商户号 sub_mchid string[1, 32] body子商户商户号
示例值:1230000109
撤销原因 reason string[1, 50] body解除授权原因
示例值:撤销原因

请求示例


{
  "channel_id": "1230000109",
  "reason": "撤销原因",
  "service_id": "500001",
  "sub_mchid": "1230000109"
}

{
JAVA示例代码
}

返回参数


处理成功,应答无内容

返回示例

 
204
处理成功,应答无内容
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400 PARAM_ERROR 参数错误 根据错误提示,传入正确参数
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请确认相同单号是否使用了不同的参数
404 ORDER_NOT_ EXIST 订单不存在 确认入参,传入正确单据
400 INVALID_ORDER_STATE 单据状态错误 确认操作是否符合流程
400 ORDER_CANCELED 单据已取消 当前状态无需操作
400 ORDER_DONE 订单已完成 当前状态无需操作




授权/解除授权服务回调通知

最新更新时间:2022.06.16 版本说明

微信支付分通过授权/解除授权服务通知接口将用户通过授权/解除授权服务消息通知给商户

注意:

• 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是,当商户系统收到通知进行处理时,先检查对应业务数据的状态,并判断该通知是否已经处理。如果未处理,则再进行处理;如果已处理,则直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。


• sub_openid 和 openid 只会返回一个字段,标识授权/解除授权的用户标识


特别提醒:商户系统对于服务授权/解除授权结果通知的内容一定要做签名验证,并校验通知的信息是否与商户侧的信息一致,防止数据泄露导致出现“假通知”,造成资金损失。

接口说明

适用对象:从业机构

请求URL:该链接是通过[商户预授权]提交notify_url设置,必须为https协议。如果链接无法访问,商户将无法接收到微信通知。 通知url必须为直接可访问的url,不能携带参数。示例: “http://pay.weixin.qq.com/wxpay/pay.action”

通知规则

用户授权/解除授权完成后,微信后台会把用户的openid和商户的out_request_no(授权服务专属)的关联信息发送给商户,以便关联请求的上下文(商户需要通过openid来给相应用户下单),商户需要接收处理该消息,并返回应答。

对后台通知交互时,如果微信收到商户的应答不符合规范或超时,微信认为通知失败,微信会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但微信不保证通知最终能成功。 (通知频率为0s/15s/15s/30s/180s/1800s/1800s/1800s/1800s/3600s)3600s后为周期进行重试(3600S为一个周期),重试超过3天后不再通知。

通知报文

服务授权/解除授权结果通知是以POST方法访问商户设置的通知url,通知的数据以JSON格式通过请求主体(BODY)传输。通知的数据包括了加密的授权/解除授权结果详情。
(注:由于涉及到回调加密和解密,商户必须先设置好apiv3密钥后才能解密回调通知,apiv3密钥设置文档指引详见APIv3密钥设置指引


下面详细描述对通知数据进行解密的流程:

  1. 1、用商户平台上设置的APIv3密钥【微信商户平台—>账户中心-->账户设置—>API安全—>设置APIv3密钥】,记为apiv3 key。
  2. 2、针对resource.algorithm中描述的算法(目前为AEAD_AES_256_GCM),取得对应的参数nonce和associated_data。
  3. 3、使用apiv3 key、nonce和associated_data,对数据密文resource.ciphertext进行解密,得到JSON形式的资源对象。

注: AEAD_AES_256_GCM算法的接口细节,请参考rfc5116。微信支付使用的密钥apiv3 key长度为32个字节,随机串nonce长度12个字节,associated_data长度小于16个字节并可能为空。

通知参数

参数名 变量 类型[长度限制] 必填 描述
通知ID id string[1,36] 通知的唯一ID。
示例值:EV-2018022511223320873
通知创建时间 create_time string[1,32] 通知创建的时间,格式为yyyyMMddHHmmss(标准iso8601时间格式)
遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00
通知类型 event_type string[1,32] 通知的类型
1、授权成功通知的类型为PAYSCORE.USER_OPEN_SERVICE
2、解除授权成功通知的类型为PAYSCORE.USER_CLOSE_SERVICE
示例值:PAYSCORE.USER_OPEN_SERVICE
通知数据类型 resource_type string[1,32] 通知的资源数据类型,授权/解除授权成功通知为encryptresource。
示例值:encrypt-resource
+通知数据 resource object 通知资源数据
json格式,见示例
参数名 变量 类型[长度限制] 必填 描述
加密算法类型 algorithm string[1,32] 对授权结果数据进行加密的加密算法,目前只支持AEAD_AES_256_GCM。
示例值:AEAD_AES_256_GCM
数据密文 ciphertext string[1,1048576] Base64编码后的授权/解除授权结果数据密文。
附加数据 associated_data string[1,16] 附加数据
随机串 nonce string[1,16] 加密使用的随机串。
示例值:fdasflkja484w
回调摘要 summary string[1,64] 回调摘要
示例值:授权成功

通知签名

加密不能保证通知请求来自微信。微信会对发送给商户的通知进行签名,并将签名值放在通知的HTTP头Wechatpay-Signature。商户应当验证签名,以确认请求来自微信,而不是其他的第三方。签名验证的算法请参考 《微信支付API v3签名验证》

回调示例

授权结果通知


{
    "id":"EV-2018022511223320873",
    "create_time":"2015-05-20T13:29:35+08:00",
    "resource_type":"encrypt-resource",
    "event_type":"PAYSCORE.USER_OPEN_SERVICE",
    "resource" : {
        "algorithm":"AEAD_AES_256_GCM",
        "ciphertext": "...",
        "nonce": "...",
        "associated_data": "",
    },
	"summary": "授权成功"
}
}

商户对resource对象进行解密后,得到的资源对象示例


{
  "appid": "wxd678efh567hg6787",
  "mch_id": "1230000109",
  "sub_appid": "wxd678efh567hg6787",
  "sub_mch_id": "1230000109",
  "service_id": "500001",
  "sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "user_service_status":"USER_OPEN_SERVICE",
  "openorclose_time":"20180225112233",
  "authorization_code" : "4534323JKHDFE1243252"
}

解除授权结果通知


{
   "id":"EV-2018022511223320873",
   "create_time":"2019-07-30T16:36:59+08:00",
   "resource_type":"encrypt-resource",
   "event_type":"PAYSCORE.USER_CLOSE_SERVICE",
   "resource" : {
       "algorithm":"AEAD_AES_256_GCM",
       "ciphertext": "...",
       "nonce": "...",
       "associated_data": "",
  }
}

商户对resource对象进行解密后,得到的资源对象示例


{
  "appid": "wxd678efh567hg6787",
  "mch_id": "1230000109",
  "sub_appid": "wxd678efh567hg6786",
  "sub_mch_id": "1230000109",
  "service_id": "500001",
  "sub_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "user_service_status":"USER_CLOSE_SERVICE",
  "openorclose_time":"20180225112233",
  "authorization_code" : "4534323JKHDFE1243252"
}

授权/解除授权成功通知参数

参数名 变量 类型[长度限制] 必填 描述
应用ID appid string[1,32] 调用授权服务接口提交的应用ID。
示例值:wxd678efh567hg6787
商户号 mchid string[1,32] 调用授权服务接口提交的商户号。
示例值:1230000109
子商户应用ID sub_appid string[1,32] 子商户申请的公众号或移动应用APPID 
示例值:wxd678efh567hg6787
子商户的商户号 sub_mchid string[1,32] 子商户商户号,由微信支付生成并下发
示例值:1230000109
渠道商商户号 channel_id string[1,32] 调用授权服务接口提交的渠道商商户号。
示例值:1230000109
服务ID service_id string[1,32] 调用授权服务接口提交的服务ID。
示例值:1234323JKHDFE1243252
用户标识 openid string[1,128] 二选一 微信用户在商户对应appid下的唯一标识。(传了sub_appid的情况下则只返回sub_openid)
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
子商户公众号下openid sub_openid string[1,128] 微信用户在商户对应sub_appid下的唯一标识。(传了sub_appid的情况下则只返回sub_openid)
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
回调状态 user_service_status string[1,32] 1、USER_OPEN_SERVICE:授权成功 
2、USER_CLOSE_SERVICE:解除授权成功
示例值:USER_OPEN_SERVICE
服务授权/解除授权时间 openorclose_time string[1,32] 服务授权/解除授权成功时间。
示例值:20180225112233
授权协议号 authorization_code string[1,32] 授权协议号
示例值:1275342195190894594

通知应答

接收成功:HTTP应答状态码需返回200或204,无需返回应答报文。

接收失败:HTTP应答状态码需返回5XX或4XX,同时需返回应答报文,格式如下:

参数名 变量 类型[长度限制] 必填 描述
返回状态码 code string[1,32] 错误码,SUCCESS为接收成功,其他错误码为失败。
示例值:FAIL
返回信息 message string[1,64] 返回信息,如非空,为错误原因。
示例值:失败


{   
    "code": "FAIL",
    "message": "失败"
}


APP调起支付分-授权服务

最新更新时间:2022.06.09 版本说明

商户通过调用授权服务接口打开微信支付分小程序,引导用户授权服务(APP端)

简介

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接口不能跳转到微信,此时开发者应提示用户更新微信版本。

接口参数

Android对应对象:WXOpenBusinessView.Req

iOS对应对象:WXOpenBusinessViewReq

Object WXOpenBusinessView.Req & Object WXOpenBusinessViewReq

参数名 变量 类型[长度限制] 必填 描述
跳转类型 businessType string[1,16] 固定配置:wxpayScoreEnable
示例值:wxpayScoreEnable
+ 业务参数 query string[1,2048] 使用URL的query string
方式传递参数,格式为key=value&key2=value2,其中value,value2需要进行UrlEncode处理。
示例值:见query示例
参数名 变量 类型[长度限制] 必填 描述
预授权token apply_permissions_token string[1,2048] 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入,有效期为1小时;apply_permissions_token可以从《预授权API》接口的返回参数中获取。
示例值:1230000109
其他配置 extInfo string[1,128] 自定义ext信息,json格式,如需指定小程序版本,可填 {"miniProgramType": type},默认正式版。

type取值:
0:正式版
示例值:{"miniProgramType": 0}


WXOpenBusinessViewReq *req = [WXOpenBusinessViewReq object];
req.businessType = @"wxpayScoreEnable";
req.query = @"apply_permissions_token=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2";
req.extInfo = @"{\"miniProgramType\":0}";
[WXApi sendReq:req];

int wxSdkVersion = api.getWXAppSupportAPI();
if (wxSdkVersion >= Build.OPEN_BUSINESS_VIEW_SDK_iNT) {
  WXOpenBusinessView.Req req = new WXOpenBusinessView.Req();
  req.businessType = "wxpayScoreEnable";
  req.query = "apply_permissions_token=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2";
  req.extInfo = "{\"miniProgramType\": 0}";
  Boolean ret = api.sendReq(req);
} else {
  /*需提示用户升级微信版本*/
}
​
/********在WXEntryActivity的onResp里面接收回调,示例全码*******/
@Override
public void onResp(BaseResp r) {
  if (r.getType() == ConstantsAPI.COMMAND_OPEN_BUSINESS_VIEW) {
    WXOpenBusinessView.Resp launchMiniProgramResp = (WXOpenBusinessView.Resp) r;
    string
 text = string
 .format("nextMsg=%snerrStr=%snbusinessType=%s",
                resp.extMsg, resp.errStr, resp.businessType);
    Toast.makeText(this, text, Toast.LENGTH_lONG).show();
  }
}	
    


JSAPI调起支付分-授权服务

最新更新时间:2022.06.09 版本说明

商户通过调用授权服务接口打开微信支付分小程序,引导用户授权服务(Web端)

简介

接口名称: openBusinessView

接口兼容:

此接口引用 JSAPI版本1.5.0,引用地址:https://res.wx.qq.com/open/js/jweixin-1.5.0.js

要求用户微信版本>=7.0.5

接口参数

Object

参数名 变量 类型[长度限制] 必填 描述
跳转类型 businessType string[1,16] 固定配置:wxpayScoreEnable
示例值:wxpayScoreEnable
+ 业务参数 queryString string[1,2048] 使用URL的query string
方式传递参数,格式为key=value&key2=value2,其中value,value2需要进行UrlEncode处理。
示例值:见querystring示例
参数名 变量 类型[长度限制] 必填 描述
预授权token apply_permissions_token string[1,2048] 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入,有效期为1小时;apply_permissions_token可以从《预授权API》接口的返回参数中获取。
示例值:1230000109
	
let wechatInfo = navigator.userAgent.match(/MicroMessenger\/([\d\.]+)/i);
let wechatVersion = wechatInfo[1];

if (compareVersion(wechatVersion, '7.0.5') >= 0) {
   goToWXScore();
} else {
   // 提示用户升级微信客户端版本
   window.href = 'https://support.weixin.qq.com/cgi-bin/readtemplate?t=page/
   common_page__upgrade&text=text005&btn_text=btn_text_0'
}

/**
 * 跳转微信支付分
 */
function goToWXScore() {
    wx.checkJsApi({
        jsApiList: ['openBusinessView'], // 需要检测的JS接口列表
        success: function (res) {
        // 以键值对的形式返回,可用的api值true,不可用为false
        // 如:{"checkResult":{"openBusinessView":true},"errMsg":"checkJsApi:ok"}
        if (res.checkResult.openBusinessView) {
            wx.invoke(
                'openBusinessView', {
                    businessType: 'wxpayScoreEnable',
                    queryString: 'apply_permissions_token=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2'
                },
                function (res) {
                // 从微信侧小程序返回时会执行这个回调函数
                    if (parseint(res.err_code) === 0) {s
                    // 返回成功 
                    } else {
                    // 返回失败
                    }
                });
            }
        }
    });
 }

 /**
  * 版本号比较
  * @param {string} v1 
  * @param {string} v2 
  */
function compareVersion(v1, v2) {
    v1 = v1.split('.')
    v2 = v2.split('.')
    const len = Math.max(v1.length, v2.length)
  
    while (v1.length < len) {
      v1.push('0')
    }
    while (v2.length < len) {
      v2.push('0')
    }
  
    for (let i = 0; i < len; i++) {
      const num1 = parseint(v1[i])
      const num2 = parseint(v2[i])
  
      if (num1 > num2) {
        return 1
      } else if (num1 < num2) {
        return -1
      }
    }
  
    return 0
 }

int wxSdkVersion = api.getWXAppSupportAPI();
if (wxSdkVersion >= Build.OPEN_BUSINESS_VIEW_SDK_iNT) {
  WXOpenBusinessView.Req req = new WXOpenBusinessView.Req();
  req.businessType = "wxpayScoreEnable";
  req.query = "mch_id=1230000109&service_id=88888888000011&
  out_request_no=1234323JKHDFE1243252&
  timestamp=1530097563&nonce_str=zyx53Nkey8o4bHpxTQvd8m7e92nG5mG2&
  sign_type=HMAC-SHA256&sign=029B52F67573D7E3BE74904BF9AEA";
  req.extInfo = "{\"miniProgramType\": 0}";
  Boolean ret = api.sendReq(req);
} else {
  /*需提示用户升级微信版本*/
}
​
/********在WXEntryActivity的onResp里面接收回调,示例全码*******/
@Override
public void onResp(BaseResp r) {
  if (r.getType() == ConstantsAPI.COMMAND_OPEN_BUSINESS_VIEW) {
    WXOpenBusinessView.Resp launchMiniProgramResp = (WXOpenBusinessView.Resp) r;
    string
text = string
.format("nextMsg=%snerrStr=%snbusinessType=%s", resp.extMsg, resp.errStr, resp.businessType); Toast.makeText(this, text, Toast.LENGTH_lONG).show(); } }



小程序调起支付分-授权服务

最新更新时间:2022.06.09 版本说明

商户通过调用授权服务接口打开微信支付分小程序,引导用户授权服务(小程序端)

简介

商户小程序跳转微信侧小程序建议使用两种方式:调用wx.openBusinessView或者wx.navigateToMiniProgram。其中wx.openBusinessView不占用小程序跳转其他小程序的数量名额。

1.1 wx.openBusinessView

接口名称:wx.openBusinessView

接口兼容:
●小程序版本库 >= 2.6.0,低版本需提示用户升级微信版本。
● iOS兼容性表现:若微信版本 >= 7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本 < 7.0.3,开发者通过此openSDK接口可以跳转到微信,但不能跳转到微信支付分小程序,此时微信会提示用户可能由于应用的请求非法或者微信版本过低。
● Android兼容性表现:若微信版本 >=7.0.3,开发者可以通过此openSDK接口跳转到微信支付分小程序;若微信版本 < 7.0.3,开发者通过此openSDK接口不能跳转到微信,此时开发者应提示用户更新微信版本。

接口参数

Object object

参数名 变量 类型[长度限制] 必填 描述
跳转类型 businessType string[1,32] 固定配置:wxpayScoreEnable
示例值:wxpayScoreEnable
+业务参数 extraData Object 需要传递给支付分的业务数据。
参数名 变量 类型 必填 描述
预授权token apply_permissions_token string[1,2048] 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入,有效期为1小时;apply_permissions_token可以从《预授权API》接口的返回参数中获取。
示例值:1230000109

wx.openBusinessView({
  businessType: 'wxpayScoreEnable',
  extraData: {
    apply_permissions_token: '1230000109'
  },
  success() {
    //dosomething
  },
  fail() {
    //dosomething
  },
  complete() {
    //dosomething
  }
});  


1.2 wx.navigateToMiniProgram

接口名称: wx.navigateToMiniProgram,详见小程序API文档

接口参数

Object object

参数名 变量 类型[长度限制] 必填 描述
公众号ID appId string[1,32] 支付分公众账号ID,固定配置:wxd8f3793ea3b935b8。
示例值:wxd8f3793ea3b935b8
路径 path string[1,64] 固定配置:pages/use/enable
示例值:pages/use/enable
+业务参数 extraData Object 需要传递给支付分的业务数据。
参数名 变量 类型 必填 描述
预授权token apply_permissions_token string[1,2048] 用于跳转到微信侧小程序授权数据,跳转到微信侧小程序传入,有效期为1小时;apply_permissions_token可以从《预授权API》接口的返回参数中获取。
示例值:1230000109

wx.navigateToMiniProgram({
  appId: 'wxd8f3793ea3b935b8',
  path: 'pages/use/enable',
  extraData: {
    apply_permissions_token: '1230000109'
  },
  success() {
    //dosomething
  },
  fail() {
    //dosomething
  },
  complete() {
    //dosomething
  }
});  






版本说明

关闭
V1.0
2022年06月09日
微信支付分授权(机构模式)接口上线