拉起微工卡授权使用微工卡

更新时间：2025.02.19

通过小程序拉起微工卡授权使用微工卡。

wx.navigateToMiniProgram

支持商户：【普通服务商】

接口名称： wx.navigateToMiniProgram，详见小程序跳转API文档

微工卡AppID： wxd24d9057cd83d47a

path路径： /pages/card/auth

接口参数

Query 查询参数

mchid 必填 string(32)

【服务商商户号】微信服务商商户的商户号，由微信支付生成并下发。

sub_mchid 必填 string(32)

【子商户号】微信服务商下特约商户的商户号，由微信支付生成并下发。

appid 选填 string(32)

【服务商应用ID】与服务商商户号有绑定关系的AppID。应用ID和子商户应用ID其中必须有一个与当前小程序AppID一致。

sub_appid 选填 string(32)

【子商户应用ID】与子商户商户号有绑定关系的AppID。应用ID和子商户应用ID其中必须有一个与当前小程序AppID一致。

openid 必填 string(64)

【用户标识】用户在商户对应AppID下的唯一标识。

token 必填 string(64)

【授权token】通过接口生成的预授权token。

请求示例

1wx.navigateToMiniProgram({
2  appId: 'wxd24d9057cd83d47a',
3  path: '/pages/card/auth?mchid=123456&sub_mchid=666666&appid=wx1234567889999&token=qfq-34ewq257w_1re4re&openid=o17o88-JPyaisuNH-8RXGwcfb4zE',
4  success(res) {
5    // 打开成功
6  }
7})

授权成功返回结果

授权成功结果通过小程序带参返回上一个小程序的extraData 传递，具体参数如下：

注意

授权成功结果仅当用户点击微工卡授权结果页的“完成”按钮才有信息返回，如果用户通过点击左上角返回按钮或者右滑屏幕返回，则无结果消息。所以请做好兜底查询逻辑，不要强依赖此方法。

msg_type 必填 string(64)

【消息类型】标识本次返回结果的消息类型，此处为授权的消息，为： AUTH。

authorize_state 必填 string(64)

【授权状态】返回信息，如非空，为错误原因。

获取返回结果示例

通过在 app.js 中调用 App 方法注册小程序实例时，绑定 onShow 函数获取返回结果。

详细的参数含义和使用请参考 App参考文档。

示例代码

1App({
2    onShow (options) {
3        // 场景数值为1038（从其他小程序跳回），跳回的小程序appid为wxd24d9057cd83d47a
4        if (options.scene === 1038 && options.referrerInfo && options.referrerInfo.appId === 'wxd24d9057cd83d47a') {
5            const resp = options.referrerInfo.extraData || {};
6            if (resp.msg_type === 'AUTH' && resp.authorize_state === 'AUTHORIZED') {
7                // TODO 处理授权成功返回结果
8            }
9        }
10    },
11})

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

错误码	描述	解决方案
403	REQUEST_BLOCKED	特约商户未开启手动提现权限
400	PARAM_ERROR	参数错误
404	ORDER_NOT_EXIST	提现单号不存在
403	NOT_ENOUGH	特约商户号账户可用余额不足
403	NO_AUTH	无接口使用权限
400	INVALID_REQUEST	特约商户未开启手动提现权限
429	FREQUENCY_LIMITED	频率限制
403	CONTRACT_NOT_CONFIRMED	特约商户未开启手动提现权限
403	ACCOUNT_NOT_VERIFIED	特约商户下行打款未成功
403	ACCOUNT_ERROR	特约商户未绑卡

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服