最新更新時間:2021.03.04 版本說明
電商平臺通過查詢申請狀態(tài)API查詢二級商戶入駐申請結(jié)果。該查詢服務提供兩種查詢方式(兩種查詢方式返回結(jié)果一致):
方式1:業(yè)務申請編號查詢申請狀態(tài);
方式2:申請單號查詢申請狀態(tài)。
適用對象:電商平臺
請求URL:https://api.mch.weixin.qq.com/v3/ecommerce/applyments/{applyment_id}
請求方式:GET
path指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付申請單號 | 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指該參數(shù)為路徑參數(shù)
query指該參數(shù)需在請求URL傳參
body指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
業(yè)務申請編號 | out_request_no | string[1,124] | 是 | path1、服務商自定義的商戶唯一編號。 2、每個編號對應一個申請單,每個申請單審核通過后會生成一個微信支付商戶號。 示例值:APPLYMENT_00000000001 |
https://api.mch.weixin.qq.com/v3/ecommerce/applyments/out-request-no/APPLYMENT_00000000001
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
申請狀態(tài) | applyment_state | string[1,32] | 是 | 枚舉值: CHECKING:資料校驗中 ACCOUNT_NEED_VERIFY:待賬戶驗證 AUDITING:審核中 REJECTED:已駁回 NEED_SIGN:待簽約 FINISH:完成 FROZEN:已凍結(jié) 示例值:FINISH |
申請狀態(tài)描述 | applyment_state_desc | string[1,32] | 是 | 申請狀態(tài)描述 示例值:“審核中” |
簽約狀態(tài) | sign_state | string[1,16] | 否 | 1、UNSIGNED:未簽約。該狀態(tài)下,電商平臺可查詢獲取簽約鏈接,引導二級商戶的超級管理員完成簽約; 2、SIGNED :已簽約。指二級商戶的超級管理員已完成簽約。注意:若申請單被駁回,商戶修改了商戶主體名稱、法人名稱、超級管理員信息、主體類型等信息,則需重新簽約。 3、NOT_SIGNABLE:不可簽約。該狀態(tài)下,暫不支持超級管理員簽約。一般為申請單處于已駁回、已凍結(jié)、機器校驗中狀態(tài),無法簽約。 示例值:SIGNED |
簽約鏈接 | sign_url | string[1,256] | 否 | 1、當申請狀態(tài)為NEED_SIGN 或 簽約狀態(tài)為UNSIGNED時返回。 2、建議將鏈接轉(zhuǎn)為二維碼展示,需讓申請單-管理者用微信掃碼打開,完成簽約。 示例值:http://www.tg885.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec |
電商平臺二級商戶號 | sub_mchid | string[1,32] | 否 | 當申請狀態(tài)為NEED_SIGN或FINISH時才返回。 示例值:1542488631 |
+匯款賬戶驗證信息 | account_validation | object | 否 | 當申請狀態(tài)為ACCOUNT_NEED_VERIFY 時有返回,可根據(jù)指引匯款,完成賬戶驗證。 |
+駁回原因詳情 | audit_detail | array | 否 | 各項資料的審核情況。當申請狀態(tài)為REJECTED或 FROZEN時才返回。 |
法人驗證鏈接 | legal_validation_url | string[1,256] | 否 | 1、當申請狀態(tài)為 ACCOUNT_NEED_VERIFY,且通過系統(tǒng)校驗的申請單,將返回鏈接。 2、建議將鏈接轉(zhuǎn)為二維碼展示,讓商戶法人用微信掃碼打開,完成賬戶驗證。 示例值: http://www.tg885.com/public/apply4ec_sign/s?applymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec |
業(yè)務申請編號 | out_request_no | string[1,124] | 是 | 提交接口填寫的業(yè)務申請編號。 示例值:APPLYMENT_00000000001 |
微信支付申請單號 | applyment_id | uint64 | 是 | 微信支付分配的申請單號。 示例值:2000002124775691 |
{
?"applyment_state": "NEED_SIGN",
?"applyment_state_desc": "待簽約",
?"sign_state": "UNSIGNED",
?"sign_url": "http://www.tg885.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://www.tg885.com/public/apply4ec_sign/s?appl
ymentId=2000002126198476&sign=b207b673049a32c858f3aabd7d27c7ec",
?"out_request_no": "APPLYMENT_00000000001",
?"applyment_id": 2000002124775691
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調(diào)用 |
400 | PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調(diào)用 |
400 | RESOURCE_ALREADY_EXISTS | 存在流程進行中的申請單,請檢查是否重入 | 可通過查詢申請狀態(tài)查看此申請單的申請狀態(tài),或更換out_request_no提交新的申請單 |
403 | NO_AUTH | 商戶權(quán)限異常 | 請確認是否已經(jīng)開通相關權(quán)限 |
404 | RESOURCE_NOT_EXISTS | 申請單不存在 | 確認入?yún)ⅲ瑐魅胝_的申請單編號 |