开发指引
更新时间:2024.11.181. 接口规则
为了在保证支付安全的前提下,带给商户简单、一致且易用的开发体验,我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则。
2. 开发准备
2.1. 搭建和配置开发环境
开发者应当依据自身的编程语言来构建并配置相应的开发环境。
3. 快速接入
3.1. 业务流程图
重点步骤说明:
步骤2 用户使用微工卡时,商户可根据记录信息,或调用查询微工卡授权关系API接口判断用户是否授权。根据用户授权关系来展示不同入口
步骤4 如果用户未授权,可调用生成授权token API接口生成授权token信息,并拉起微工卡授权使用微工卡引导用户进行授权。
步骤14 用户授权完成后,根据查看微工卡协议拉起微工卡查看我的微工卡跳转微工卡小程序,查看微工卡信息
步骤16 商家转账,需调用发起批量转账接口完成商家微工卡批量转账
4. 常见问题
Q1:特约商户能否自己调用微工卡服务?
A1:当前微工卡服务仅支持服务商调用模式,即服务商协助特约商户完成对应服务的接入使用。
Q2:为什么用户明明授权过一次,调用微工卡相关服务时还是提示未授权?
A2:检查商户号和AppID是否配置了通用化接口权限,可以联系微信侧运营确认和配置通用化接口权限
需要注意的是,用户微工卡服务授权的维度为单个特约商户(调用授权接口时入参的特约商户商户号)。如用户加入不同企业/项目,须授权该企业/项目对应的特约商户商户号,对应特约商户才可正常使用相应功能。服务商在接入微工卡服务时,应考虑设计相应流程,确保用户在加入不同企业/项目时,完成微工卡服务授权,顺利使用相应能力。
Q3:用户在微工卡设置的收款账户是每个特约商户可以设置不同的收款账户,还是全局生效一个收款账户?
A3:收款账户为全局生效,即用户设置后,所有授权过的特约商户都将向用户当前设置的收款账户付款,不支持按照特约商户维度单独设置收款账户。用户在授权完成后,可通过微工卡页面切换银行卡设置。请服务商在小程序中注意为用户设计查看微工卡的入口。
Q4:用户一天需多次核身该如何处理,每天最多核身多少次?
A4:用户每次核身前均需预下单生成token,token有效时间为5分钟,如需多次核身、则需在每次核身前生成预下单token,通过token拉起微工卡小程序完成核身。
同一用户每天最多预下单核身20次,超出后不可再次预下单,需等待第二天再试。
Q5:用户什么情况下会核身失败,如遇核身失败该如何处理?
A5:用户核身失败仅有两种场景:
核身预下单生成的token过期(有效期5min);
当日人脸识别失败达到五次。
如token过期,服务商可重新下单、发起核身,如当日人脸识别失败达到五次,则当日后续所有核身均会失败。服务商需做好兜底流程,应对极端场景下的核身失败情况。
Q6:通过微工卡付款注意事项?
A6:微工卡付款支持到用户在微工卡内选择的收款账户(零钱或用户微信支付绑定的中国大陆储蓄卡),用户可以随时切换收款账户,切换后实时生效。付款商户可在回单中获取付款账户相关信息,如,零钱或XX银行及卡尾号后4位信息。
Q7:银行退票状态是什么,该如何处理?
A7:在极为特殊的情况下,可能会出现银行先同步入账成功状态,再因为某些特殊原因导致入账失败,通知退票。如交易出现退票,实际向用户付款失败,付款单状态由成功更新为「退票」,相应资金会退回商户账户。请在出现退票状态后,确认相应资金状态,并及时联系用户沟通其他发放方式,如更换银行卡重新发起,或选择其他发放渠道,处理好可能出现的投诉问题。