常见问题

更新时间:2026.08.05
||
提示:本功能目前处于灰度测试阶段、暂未开放使用,待全量开放后将通过文档门户公告同步,感谢您的理解。

Q:调起微工卡人脸核身(流程中完成授权)接口报错:“商户请求有误,商户号错误”,什么原因?

A:拉起人脸核身小程序传递的mchid或sub_mchid有误。

Q:微工卡查询明细单fail_reason【明细失败原因】字段返回:DAY_RECEIVED_COUNT_EXCEED,什么原因?

A:该错误表示单用户单日收款次数超限。微工卡默认限制单用户单日最多收款1次。

若需调整限额:

  • 特约商户出资:登录商户平台-产品中心-产品大全-我的工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-单日转账次数设置;

  • 服务商出资:登录服务商平台-产品中心-产品大全-工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-单日转账次数设置。

Q:微工卡发起批量转账,为什么查询的明细单接口【明细状态】detail_status为“WAIT_PAY:待确认”?

A:"detail_status":"WAIT_PAY" 表示该笔转账订单处于【待确认】状态,需等待支付方完成出资验密确认操作。

Q:微工卡在哪设置ip白名单?

A:登录服务商平台-产品中心-产品大全-我的工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-付款发起方式-API安全-添加IP白名单。

Q:微工卡是否需要设置免密额度,如何设置?

A:需要根据出资商户号设置,详细路径参考:

  • 特约商户出资:登录商户平台-产品中心-我授权的产品-“微工卡基础转账”的产品设置-基础转账-产品设置-付款验密管理-免密规则-设置;

  • 服务商出资:登录服务商平台-产品中心-产品大全-我的工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-付款验密管理-免密规则-设置。

Q:现在批量转账每次都需要验密,如何设置免密?

A:可根据出资商户号设置,详细路径参考:

  • 特约商户出资:登录商户平台-产品中心-我授权的产品-“微工卡基础转账”的产品设置-基础转账-产品设置-付款验密管理-免密规则-设置;

  • 服务商出资:登录服务商平台-产品中心-产品大全-我的工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-付款验密管理-免密规则-设置。

Q:发起批量转账报错:{"code":"INVALID_REQUEST","message":"API通道未开启"},如何解决?

A:服务商登录服务商平台-产品中心-产品大全-我的工具箱-微工卡-产品设置-微工卡基础转账-前往功能-产品设置-付款发起方式-开启API方式。

Q:微工卡设置每人每日收款限额1000元,若当天转账1000元失败,今天还能再发起转账吗?

A:能,转账失败会退回额度。

Q:调用发起批量转账接口时,用户是否必须开通微工卡?

A:不需要,若用户未开通微工卡,调用接口后资金将转账至用户微信零钱;若需转账至银行卡 ,需用户授权开通微工卡。

Q:发起批量转账接口报错:“商户运营账户资金不足,充值后可以原单号发起重试,请勿更换商户单号“ ,若不按原单号重新请求有什么后果?

A:一般返回该报错不会受理,充值之后也不会自动转账,但是建议原单重试,避免造成重复转账风险,原单重试最保险。

Q:​微工卡人脸核身(流程中完成授权)接口是否支持外国人、港澳台用户使用?

A:目前微工卡仅支持中国大陆地区及具备祖国大陆身份证户籍同胞开通使用,港澳台和国外籍暂不支持。

Q:微工卡,当批次状态为PROCESSING时,transfer_detail_list中的明细状态为FAIL是否准确?该状态是否会后续改变?

A:最终结果需要等待批次状态变为FINISHED(已完成)后,再去查询明细单状态确认。

Q:用户未开通微工卡,是否仍可通过微工卡通道发起转账?

A:​ 可以。用户未在商户侧授权开通微工卡,不影响向其发起转账。但该场景下资金仅可转入用户微信零钱,不支持转账至银行卡。

Q:当“微工卡转账批次单”状态为“已关闭”时,转账明细处于什么状态?转账明细状态中的“退票”又代表什么含义?

A:​ 批次单状态为“已关闭”时,不会生成转账明细单,查询时将无明细信息返回。“退票”指因银行侧原因导致转账被退回。

Q:调用微工卡接口时返回错误码 INVALID_REQUEST,提示“此IP地址不允许调用接口,请按开发指引设置”,该如何解决?

A:​ 该报错表示当前发起请求的服务器公网 IP 未在微信支付商户平台进行白名单配置。请按照以下步骤添加 IP 地址:

登录服务商平台 > 产品中心​ > 产品大全​ > 我的工具箱​ > 微工卡​ > 产品设置​ > 微工卡基础转账​ > 前往功能​ > 产品设置​ > 安全配置 > IP添加。

Q:调用特约商户银行来账查询接口时提示“当天充值记录数过多,请登录商户平台查询”,该接口的查询记录数能否申请上调?

A: 暂不支持上调。该接口存在查询限制,当天充值记录数超过 200 笔 时,将无法查询,请直接登录商户平台进行查看。

Q:微工卡向个人打款时,需在微信端进行确认(打款提醒),这个确认步骤可取消吗?​

A:​ 可以。该确认步骤(验密)是否开启取决于商户侧的配置,支持通过以下路径进行调整:

特约商户出资:

登录商户平台 →【产品中心】→【我授权的产品】→“微工卡基础转账”的产品设置 →【基础转账】→【产品设置】→【付款验密管理】→【免密规则】→ 进行设置。

服务商出资:

登录服务商平台 →【产品中心】→【产品大全】→【我的工具箱】→【微工卡】→【产品设置】→【微工卡基础转账】→【前往功能】→【产品设置】→【付款验密管理】→【免密规则】→ 进行设置。

反馈
目录
置顶