最新更新时间:2022.04.08 版本说明
电商平台通过查询申请状态API查询二级商户入驻申请结果。该查询服务提供两种查询方式(两种查询方式返回结果一致):
方式1:业务申请编号查询申请状态;
方式2:申请单号查询申请状态。
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/{applyment_id}
请求方式:GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付申请单号 | applyment_id | uint64 | 是 | path申请单的主键,唯一定义此资源的标识。 示例值:2000002124775691 |
https://api.mch.weixin.qq.com/v3/ecommerce/applyments/2000002124775691
适用对象:电商平台
请求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/{out_request_no}
请求方式:GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
业务申请编号 | out_request_no | string[1,124] | 是 | path1、服务商自定义的商户唯一编号。 2、每个编号对应一个申请单,每个申请单审核通过后会生成一个微信支付商户号。 示例值:APPLYMENT_00000000001 |
https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/APPLYMENT_00000000001
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
申请状态 | applyment_state | string[1,32] | 是 | 枚举值: CHECKING:资料校验中 ACCOUNT_NEED_VERIFY:待账户验证 AUDITING:审核中 REJECTED:已驳回 NEED_SIGN:待签约 FINISH:完成 FROZEN:已冻结 CANCELED:已作废 示例值:FINISH |
申请状态描述 | applyment_state_desc | string[1,1024] | 是 | 申请状态描述 示例值:“完成” |
签约状态 | sign_state | string[1,16] | 否 | 1、UNSIGNED:未签约。该状态下,电商平台可查询获取签约链接,引导二级商户的超级管理员完成签约; 2、SIGNED :已签约。指二级商户的超级管理员已完成签约。注意:若申请单被驳回,商户修改了商户主体名称、法人名称、超级管理员信息、主体类型等信息,则需重新签约。 3、NOT_SIGNABLE:不可签约。该状态下,暂不支持超级管理员签约。一般为申请单处于已驳回、已冻结、机器校验中状态,无法签约。 示例值:SIGNED |
签约链接 | sign_url | string[1,256] | 否 | 1、当申请状态为NEED_SIGN 或 签约状态为UNSIGNED时返回,该链接为永久有效; 2、申请单中的超级管理者,需用已实名认证的微信扫码打开,完成签约。 示例值:https://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec |
电商平台二级商户号 | sub_mchid | string[1,32] | 否 | 当申请状态为NEED_SIGN或FINISH时才返回。 示例值:1542488631 |
+汇款账户验证信息 | account_validation | object | 否 | 当申请状态为ACCOUNT_NEED_VERIFY 时有返回,可根据指引汇款,完成账户验证。 |
+驳回原因详情 | audit_detail | array | 否 | 各项资料的审核情况。当申请状态为REJECTED或 FROZEN时才返回。 |
法人验证链接 | legal_validation_url | string[1,256] | 否 | 1、当申请状态为 ACCOUNT_NEED_VERIFY,且通过系统校验的申请单,将返回链接。 2、建议将链接转为二维码展示,让商户法人用微信扫码打开,完成账户验证。 注:商户申请单进入审核状态后,微信侧会校验法人证件号码是否跟营业执照匹配,若匹配,返回该字段 ; 若不匹配,不支持法人扫码验证,不返回该字段。 示例值: http://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec |
业务申请编号 | out_request_no | string[1,124] | 是 | 提交接口填写的业务申请编号。 示例值:APPLYMENT_00000000001 |
微信支付申请单号 | applyment_id | uint64 | 是 | 微信支付分配的申请单号。 示例值:2000002124775691 |
{
"applyment_state": "FINISH",
"applyment_state_desc": "完成",
"sign_url": "http://pay.weixin.qq.com/public/apply4ec_sign/s?applymentId=
2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
"sub_mchid": "1542488631",
"account_validation": {
"account_name": "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0la
VvqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J+L+yx912i
tUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEv
BT4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
"account_no": "aOf7Gk2qT26kakkuTZpbFAn7Mb7xcar0LlQaYoi3+LnnWwgAsfaUUTg9+GmYJq6YCz+RiluWHeHFq1lt8n3eIkF0laV
vqmAU80xIWGZgWJnRmnRuZxsg0HJZfnUac2JfqyuL8OoyM2YSuYDqdsyvcOlgUQgq8MPCR6pmvhBCmIeJvnVSm8J
+L+yx912itUmTDxhdBlu1CFBIUefME9nYB70vCVTNAVXgURkf65mjHMBiE9Y+wrPZVmTIIz3C3PtPVMZYDEvBT
4rDdICA3ZYXshYqeOSslSjSMf+MhhC4oaujiISFzq3AE+as7mAEDJly+DgRuVs74msmKUH8pl+3oA==",
"pay_amount": 124,
"destination_account_number": "7222223333322332",
"destination_account_name": "财付通支付科技有限公司",
"destination_account_bank": "招商银行股份有限公司深圳汉京中心支行",
"city": "深圳",
"remark": "入驻账户验证",
"deadline": "2018-12-10 17:09:01"
},
"audit_detail": [
{
"param_name": "id_card_copy",
"reject_reason": "身份证背面识别失败,请上传更清晰的身份证图片。"
}
],
"legal_validation_url": "http://pay.weixin.qq.com/public/apply4ec_sign/s?appl
ymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
"out_request_no": "APPLYMENT_00000000001",
"applyment_id": 2000002124775691
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | RATELIMIT_EXCEEDED | 系统错误 | 系统异常,请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 请使用正确的参数重新调用 |
400 | RESOURCE_ALREADY_EXISTS | 存在流程进行中的申请单,请检查是否重入 | 可通过查询申请状态查看此申请单的申请状态,或更换out_request_no提交新的申请单 |
403 | NO_AUTH | 商户权限异常 | 请确认是否已经开通相关权限 |
404 | RESOURCE_NOT_EXISTS | 申请单不存在 | 确认入参,传入正确的申请单编号 |