最新更新時間:2022.05.13 版本說明
服務商(銀行、支付機構、電商平臺不可用)使用該接口提交商家資料,幫助商家入駐成為微信支付的特約商戶。
流程指引請看 特約商戶進件流程
1. 商戶上送敏感信息時使用微信支付平臺公鑰加密,證書序列號包含在請求HTTP頭部的Wechatpay-Serial,詳見接口規(guī)則
適用對象:服務商
請求URL:https://api.mch.weixin.qq.com/v3/applyment4sub/applyment/
請求方式:POST
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
業(yè)務申請編號 | business_code | string[1, 124] | 是 | body1、只能由數(shù)字、字母或下劃線組成,建議前綴為服務商商戶號; 2、服務商自定義的唯一編號; 3、每個編號對應一個申請單,每個申請單審核通過后會生成一個微信支付商戶號。 示例值:1900013511_10000 |
+ 超級管理員信息 | contact_info | object | 是 | body超級管理員需在開戶后進行簽約,并可接收日常重要管理信息和進行資金操作,請確定其為商戶法定代表人或負責人。 |
+ 主體資料 | subject_info | object | 是 | body請?zhí)顚懮碳业臓I業(yè)執(zhí)照/登記證書、經(jīng)營者/法人的證件等信息 |
+ 經(jīng)營資料 | business_info | object | 是 | body請?zhí)顚懮碳业慕?jīng)營業(yè)務信息、售賣商品/提供服務場景信息 |
+ 結算規(guī)則 | settlement_info | object | 是 | body請?zhí)顚懮碳业慕Y算費率規(guī)則、特殊資質等信息 |
+ 結算銀行賬戶 | bank_account_info | object | 是 | body請?zhí)顚懮碳姨岈F(xiàn)收款的銀行賬戶信息 |
+ 補充材料 | addition_info | object | 否 | body根據(jù)實際審核情況,會額外要求商家提供指定的補充資料 |
{
"business_code": "1900013511_10000",
"contact_info": {
"business_authorization_letter": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"contact_email": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"contact_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"contact_id_number": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"contact_period_begin": "2019-06-06",
"contact_period_end": "2026-06-06",
"contact_type": "LEGAL",
"mobile_phone": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"openid": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg== 字段加密: 使用APIv3定義的方式加密"
},
"subject_info": {
"subject_type": "SUBJECT_TYPE_ENTERPRISE",
"finance_institution": true,
"business_license_info": {
"legal_person": "張三",
"license_address": "廣東省深圳市南山區(qū)xx路xx號",
"license_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"license_number": "123456789012345678",
"merchant_name": "騰訊科技有限公司",
"period_begin": "2019-08-01",
"period_end": "2029-08-01"
},
"certificate_letter_copy": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"finance_institution_info": {
"finance_license_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
"finance_type": "BANK_AGENT"
},
"identity_info": {
"authorize_letter_copy": "47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_card_info": {
"card_period_begin": "2026-06-06",
"card_period_end": "2026-06-06",
"id_card_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"id_card_copy": "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"id_card_name": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"id_card_national": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4",
"id_card_number": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="
},
"id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"id_holder_type": "LEGAL",
"owner": true
},
"ubo_info_list": [{
"ubo_id_doc_address": "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
"ubo_id_doc_copy": "jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_copy_back": "jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ",
"ubo_id_doc_name": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_number": "AOZdYGISxo4y44/Ug4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"ubo_id_doc_type": "IDENTIFICATION_TYPE_IDCARD",
"ubo_period_begin": "2019-06-06",
"ubo_period_end": "2026-06-06"
}]
},
"business_info": {
"merchant_shortname": "張三餐飲店",
"sales_info": {
"app_info": {
"app_appid": "wx1234567890123456",
"app_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
},
"biz_store_info": {
"biz_address_code": "440305",
"biz_store_address": "南山區(qū)xx大廈x層xxxx室",
"biz_store_name": "大郎燒餅",
"biz_sub_appid": "wx1234567890123456",
"indoor_pic":["0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
"store_entrance_pic": ["0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
},
"mini_program_info": {
"mini_program_appid": "wx1234567890123456",
"mini_program_pics": "0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
},
"mp_info": {
"mp_appid": "wx1234567890123456",
"mp_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
},
"sales_scenes_type": [
"SALES_SCENES_STORE",
"SALES_SCENES_MP",
"SALES_SCENES_MINI_PROGRAM",
"SALES_SCENES_WEB",
"SALES_SCENES_APP",
"SALES_SCENES_WEWORK"
],
"web_info": {
"domain": "http://www.qq.com",
"web_appid": "wx1234567890123456",
"web_authorisation": "47ZC6GC-vnrbEny__Ie_An5-tCpqxucuxi-vByf3Gjm7KE53JXvGy9tqZm2XAUf-4KGprrKhpVBDIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"
},
"wework_info": {
"corp_id": "wx1234567890123456",
"sub_corp_id": "wx1234567890123456",
"wework_pics": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"]
}
},
"service_phone": "0758XXXXX"
},
"settlement_info": {
"activities_additions": ["0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"],
"activities_id": "716",
"activities_rate": "0.6%",
"qualification_type": "餐飲",
"qualifications": "0P3ng6KTIW4-Q_l2FjmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo",
"settlement_id": "719"
},
"bank_account_info": {
"account_bank": "工商銀行",
"account_cert_info": {
"other_cert_pics": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"],
"relation_cert_pic": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"],
"settlement_cert_pic": ["47ZC6GC-vnrbEny_Ie_An5-tCpqxucuxi-vByf3Gjm7KEIUv0OF4wFNIO4kqg05InE4d2I6_H7I4"]
},
"account_name": "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
"account_number": "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w==",
"bank_account_type": "BANK_ACCOUNT_TYPE_CORPORATE",
"bank_address_code": "110000",
"bank_branch_id": "402713354941"
},
}
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付申請單號 | applyment_id | int | 是 | 微信支付分配的申請單號 示例值:2000002124775691 |
{
"applyment_id": 2000002124775691
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEMERROR | 系統(tǒng)錯誤 | 系統(tǒng)異常,請使用相同參數(shù)稍后重新調用 |
400 | PARAM_ERROR | 參數(shù)錯誤 | 請使用正確的參數(shù)重新調用 |
400 | PROCESSING | 存在流程進行中的申請單,請檢查是否重入 | 可通過查詢申請單狀態(tài)查看此申請單的申請狀態(tài),或更換business_code提交新的申請單 |
403 | NO_AUTH | 商戶權限異常 | 請確認是否已經(jīng)開通相關權限 |
429 | RATE_LIMITED | 頻率限制 | 請降低調用頻率 |
400 | APPLYMENT_NOTEXIST | 申請單不存在 | 確認入?yún)ⅲ瑐魅胝_的申請單編號 |
400 | PARAM_ERROR | 圖片文件為空 | 商戶更換文件后,重新調用 |
403 | REQUEST_BLOCKED | 未知圖片類型 | 圖片類型必須為JPG、BMP、PNG |
圖片meta信息不一致 | 請檢查meta信息是否正確 | ||
簽名信息不匹配 | 請檢查簽名信息 |