功能说明
为商户发起微信/支付宝实名认证申请(JSAPI 支付、当面付等产品的前置条件)。认证按支付机构维度发起,路径区分微信与支付宝。- 前置条件:商户状态为
ACTIVE,且该机构进件已完成(COMPLETED)或电话核身完成(PHONE_VERIFIED);不满足时返回 400BUSINESS_ERROR,文案说明当前状态; - 同一商户 + 同一机构 + 同一渠道只允许一笔认证申请,重复申请返回 400
BUSINESS_ERROR「已申请认证,请勿重复提交」; - 申请响应不返回二维码。平台渲染后的认证二维码通过认证结果查询的
qr_code获取; - 机构差异:易宝真实发起认证申请并返回申请单号;易生透传渠道申请状态;付临门为机构自动认证,返回
AUTO_AUTH且无申请单号。
POST
请求路径:
请求参数
响应参数
认证申请状态说明
apply_status 为平台统一码(各机构原始码已由平台映射,不会返回数字码):
示例
请求(微信认证,易生支付)申请成功后请间隔 30 秒以上轮询认证结果查询:
apply_status 推进至 PASSED 后,认证结果查询响应中的 qr_code 供商户扫码完成微信/支付宝侧授权。