接口说明
| 接口名称 | merchant_confirm |
|---|---|
| 是否幂等 | 否 |
| 接口模式 | 直连 |
| 异步通知 | 否 |
应用场景
收单机构通过此接口对报备信息进行二次认证，渠道后续会对交易中上送的终端信息进行校验。
接口参数
- 请求：
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 交易商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 交易终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户识别码 | subMchId | 否 | S(30) | 微信/支付宝分配的商户识别码 | |
| 商户认证单号 | merchantConfirmNo | 是 | S(64) | 20211220120030798 | 商户认证单号 |
| 商户认证信息 | merchantConfirmInfo | 是 | C | JSON格式，根据传入报备类型，查看相应的商户认证信息说明 详见：商户认证信息参数：merchantConfirmInfo |
- 微信参数:
商户认证信息：merchantConfirmInfo
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 联系人信息 | contact_info | 是 | 联系人信息，联系人是商户的联系人，将接收开户信息及日常重要管理信息，请确定联系人为商户法定代表人或经营者再进行操作。如联系人非商户法定代表人或经营者，请提交经办人身份证件和业务办理授权函。 | ||
| 主体信息 | subject_info | 是 | 主体信息 | ||
| 法人身份信息 | identification_info | 是 | 法人身份信息 | ||
| 最终受益人信息列表(UBO) | ubo_info_list | 否 | C | 企业需要填写。若经营者/法人不是最终受益所有人，则需提填写受益所有人信息，最多上传4个。若经营者/法人是最终受益所有人之一，可在此填写其他受益所有人信息，最多上传3个。根据国家相关法律法规，需要提供公司受益所有人信息，受益所有人需符合至少以下条件之一： 1、直接或者间接拥有超过25%公司股权或者表决权的自然人。 2、通过人事、财务等其他方式对公司进行控制的自然人。 3、公司的高级管理人员，包括公司的经理、副经理、财务负责人、上市公司董事会秘书和公司章程规定的其他人员。 |
|
| 补充材料 | addition_info | 否 | 根据实际审核情况，额外要求商家提供指定的补充资料 | ||
| - 待确认商户号列表 | confirm_mchid_list | 否 | C | 示例值：20001113 | 1、若有填写，创建申请单后，商家可扫码打开申请单的二维码，提前完成授权商户号； 详细流程请看产品指引 2、商户号填写要求如下： （1）请确保商户号全称与申请单主体名称一致； （2）如特殊行业商户，请确保商户号结算规则ID与经营许可证匹配； （3）一个申请单最多可以提交20个商户号。 3、校验报错说明 （1）提交申请单不满足上述要求，则无法创建申请单，返回报错格式参考如下。 “123456789:待确认商户号不存在，请检查待确认商户号是否正确;1234567:查询待确认商户信息发生系统失败，请稍后再试[269795842];999990017:待确认商户号不是当前从业机构的特约商户” （2）若服务商需实现剔除报错商户号逻辑，建议根据格式（如标点符号）筛选商户号，不根据报错文案筛选（因后续可能调整文案）。 |
商户联系人信息：contact_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 联系人类型 | contact_type | 是 | 示例值：LEGAL | 1、主体为“小微/个人卖家 ”，可选择：LEGAL：经营者/法人。 2、主体为“个体工商户/企业/政府机关/事业单位/社会组织”，可选择：LEGAL：经营者/法人、SUPER：经办人。 （经办人：经商户授权办理微信支付业务的人员） |
|
| 联系人姓名 | name | 是 | S(2，100) | 示例值：Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLHAJYLsNxJzujb9VA== | 1、若联系人类型为“法人”，则该姓名需与法人姓名一致。 2、若联系人类型为“经办人”，则可填写实际经办人的姓名。 3、长度为2-100个字符 4、前后不能有空格、制表符、换行符 5、不能仅含数字、特殊字符 6、仅能填写数字、英文字母、汉字及特殊字符 7、该字段需进行加密处理 |
| 联系人证件类型 | contact_id_doc_type | 否 | S | 示例值：IDENTIFICATION_TYPE_IDCARD | 当联系人类型是经办人时，请上传联系人证件类型。枚举值： IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT：中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证 |
| 联系人证件号码 | id_card_number | 否 | S | 示例值：Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLHAJYLsNxJzujb9VA== | 1、若联系人类型为法人，则该身份证号码需与法人身份证号码一致。若联系人类型为经办人，则可填写实际经办人的身份证号码。 2、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码，规范如下：身份证（限中国大陆居民)：17位数字+1位数字 |
| 联系人证件正面照片 | contact_id_doc_copy | 否 | S | 示例值：jTpGmxUX3FBWVQ5NJTZvvDujqhThn4ReFxikqJ5YW6zFQ | 1、当联系人类型是经办人时，请上传联系人证件的正面照片。 2、若证件类型为身份证，请上传人像面照片。 3、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 4、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证） 5、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID |
| 联系人证件反面照片 | contact_id_doc_copy_back | 否 | S | 示例值：jTpGmxUXqRTvDujqhThn4ReFxikqJ5YW6zFQ | 1、当联系人类型是经办人时，请上传联系人证件的正面照片。 2、若证件类型为身份证，请上传人像面照片。 3、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 4、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证） 5、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID |
| 联系人证件有效期开始时间 | contact_period_begin | 否 | S | 示例值：2019-06-06 | 1、当超级管理员类型是经办人时，请上传证件有效期开始时间。 2、请按照示例值填写，日期格式应满足合法的YYYY-MM-DD格式3、开始时间不能小于1900-01-01，开始时间不能大于等于当前日期。 |
| 联系人证件有效期结束时间 | contact_period_end | 否 | S | 示例值：2026-06-06 | 1、当超级管理员类型是经办人时，请上传证件有效期结束时间。 2、请按照示例值填写，日期格式应满足合法的YYYY-MM-DD格式，若证件有效期为长期，请填写：长期。 3、结束时间大于开始时间。 |
| 联系人手机号 | mobile | 是 | S(20) | 示例值：Oiw4DS+QVyZKC3eTd7CGvGQ1/sidmLHAJYLsNxJzujb9VA== | 1、前后不能有空格、制表符、换行符 2、需满足以下任一条件 - 11位数字的手机号码 - 5-20位数字、连字符“-”、加号“+” 3、用于接收微信支付的重要管理信息及日常操作验证码 4、该字段需进行加密处理 |
主体信息：subject_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 主体类型 | subject_type | 是 | S | 示例值：SUBJECT_TYPE_ENTERPRISE | 主体类型需与营业执照/登记证书上一致，可参考选择主体指引。 SUBJECT_TYPE_ENTERPRISE：企业 SUBJECT_TYPE_INSTITUTIONS_CLONED：事业单位 SUBJECT_TYPE_INDIVIDUAL：个体工商户 SUBJECT_TYPE_OTHERS：社会组织 SUBJECT_TYPE_MICRO：小微商户 SUBJECT_TYPE_GOVERNMENT：政府机关 |
| 是否金融机构 | is_finance_institution | 否 | B | 示例值：true | 选填，请根据申请主体的实际情况填写，可参考选择金融机构指引： 1、若商户主体是金融机构，则填写：true。 2、若商户主体不是金融机构，则填写：false。若未传入将默认填写：false。 |
| 营业执照信息 | business_licence_info | 否 | 主体类型为企业/个体户时，营业执照信息必填 | ||
| - 营业执照注册号 | licence_number | 是 | S | 示例值：914201123033363296 | 1、主体为“个体工商户”时，请填写营业执照上的注册号/统一社会信用代码，格式需满足以下任一条件：-15位数字 -18位阿拉伯数字或大写英文字母（不得包含英文字母I/O/Z/S/V），并且以9开头 2、主体为“企业”时，请填写营业执照上的注册号/统一社会信用代码，格式如下：-18位阿拉伯数字或大写英文字母（不得包含英文字母I/O/Z/S/V），并且以9开头 |
| - 营业执照照片 | licence_copy | 是 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4o | 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS； 2、上传彩色照片、彩色扫描件，复印件需加盖公章鲜章。 3、水印仅限于微信支付业务相关。 4、指引与示例可参考【指引文档】5、请填写通过《图片上传API》预先上传图片生成好的MediaID |
| - 商户名称 | merchant_name | 是 | S(128) | 示例值：李四网络有限公司 | 1、长度为2-128个字符 2、前后不能有空格、制表符、换行符 3、不能仅含数字、特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 5、仅支持utf-8格式 6、个体户证件为以下情况时，按照个体户XXX命名（XXX是营业执照经营人姓名）：营业执照登记名称为空、仅含数字、仅含特殊字符、“无”、“无字号” 7、个体户不能使用“企业”“公司”或“农民专业合作社”结尾 |
| - 法人姓名 | legal_person | 是 | S(100) | 示例值：李四 | 请填写营业执照的经营者/法定代表人姓名 1、长度为2-100个字符 2、前后不能有空格、制表符、换行符 3、不能仅含特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符**** |
| - 注册地址 | company_address | 是 | S(128) | 示例值：广东省深圳市南山区xx路xx号 | 建议填写营业执照的注册地址 1、长度为4-128个字符 2、前后不能有空格、制表符、换行符 3、不能仅含数字、特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 5、仅支持utf-8格式 |
| - 营业执照有效日期 | licence_valid_date | 是 | S(128) | 示例值：["2017-10-28","2037-10-28"] | 1、日期格式应满足合法的YYYY-MM-DD格式，参见示例值 2、开始时间不能小于1900-01-01 3、若证件有效期为长期，请填写：forever。 4、开始时间不能大于等于当前日期，结束时间需大于开始时间。 |
| 登记证书信息 | certificate_info | 否 | 主体为政府机关/事业单位/社会组织时，必填。 | ||
| - 证书类型 | cert_type | 是 | S | 示例值：CERTIFICATE_TYPE_2388 | 登记证书的类型。1、主体为“政府机关/事业单位/社会组织”时，请上传登记证书类型。 当主体为事业单位时，选择此枚举值： CERTIFICATE_TYPE_2388：事业单位法人证书 当主体为政府机关，选择此枚举值： CERTIFICATE_TYPE_2389：统一社会信用代码证书 当主体为社会组织，选择以下枚举值之一： CERTIFICATE_TYPE_2389：统一社会信用代码证书 CERTIFICATE_TYPE_2394：社会团体法人登记证书 CERTIFICATE_TYPE_2395：民办非企业单位登记证书 CERTIFICATE_TYPE_2396：基金会法人登记证书 CERTIFICATE_TYPE_2520：执业许可证/执业证 CERTIFICATE_TYPE_2521：基层群众性自治组织特别法人统一社会信用代码证 CERTIFICATE_TYPE_2522：农村集体经济组织登记证 CERTIFICATE_TYPE_2399：宗教活动场所登记证 CERTIFICATE_TYPE_2400：政府部门下发的其他有效证明文件 |
| - 证书编号 | cert_number | 是 | S | 示例值：111111111111 | 请输入与所选证书类型相匹配且符合国家标准规范的证书号，其中除政府证明文件外，需满足18位阿拉伯数字或大写英文字母（不得包含英文字母I/O/Z/S/V） |
| - 证书照片 | cert_copy | 是 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO | 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS； 2、上传彩色照片、彩色扫描件，复印件需加盖公章鲜章。 3、水印仅限于微信支付业务相关。 4、指引与示例可参考【指引文档】 5、请填写通过《图片上传API》预先上传图片生成好的MediaID |
| - 法人姓名 | legal_person | 是 | S(100) | 示例值：李四 | 请填写登记证书上的法定代表人姓名 1、长度为2-100个字符 2、前后不能有空格、制表符、换行符 3、不能仅含特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 |
| - 注册地址 | company_address | 是 | S(128) | 示例值：广东省深圳市南山区xx路xx号 | 请填写登记证书的注册地址 1、长度为4-128个字符 2、前后不能有空格、制表符、换行符 3、不能仅含数字、特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 5、仅支持utf-8格式 |
| -证书有效日期 | cert_valid_date | 是 | S | 示例值：[“2017-10-28”,”2037-10-28”] | 1、日期格式应满足合法的YYYY-MM-DD格式，参见示例值 2、若证件有效期为长期，请填写：forever。 3、开始时间不能大于等于当前日期，结束时间需大于开始时间。 |
| 单位证明函照片 | company_prove_copy | 是 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdO | 1、主体类型为政府机关/事业单位时，单位证明函照片必填。 2、单位证明函格式参考示例 3、请填写通过《图片上传API》预先上传图片生成好的MediaID |
| 辅助证明材料信息 | assist_prove_info | 否 | S | ||
| - 小微经营类型 | micro_biz_type | 是 | S | 示例值： MICRO_TYPE_STORE |
MICRO_TYPE_STORE：门店场所 MICRO_TYPE_MOBILE：流动经营/便民服务 MICRO_TYPE_ONLINE：线上商品/服务交易 |
| - 门店名称 | store_name | 是 | S（50） | 示例值：大郎烧饼 | 1、填写规范：门店场所：填写门店名称 流动经营/便民服务：填写经营/服务名称线上商品/服务交易：填写线上店铺名称 2、格式规范： 长度为1-50个字符 前后不能有空格、制表符、换行符 不能仅含数字、特殊字符仅能填写数字、英文字母、汉字及特殊字符 仅支持utf-8格式 |
| - 门店省市编码 | store_address_code | 是 | S（50） | 示例值：440305 | 1、只能由数字组成 2、详细参见微信支付提供的省市对照表 3、填写规范：门店场所：填写门店省市编码流动经营/便民服务：填写经营/服务所在地省市编码线上商品/服务交易：填写卖家所在地省市编码 |
| - 门店地址 | store_address | 是 | S（4512） | 示例值：广东省深圳市南山区xx大厦x层xxxx室 | 1、填写规范：门店场所：填写店铺详细地址，具体区/县及街道门牌号或大厦楼层流动经营/便民服务：填写“无”线上商品/服务交易：填写电商平台名称 2、格式规范： 长度为4-512个字符前后不能有空格、制表符、换行符 不能仅含数字、特殊字符仅能填写数字、英文字母、汉字及特殊字符仅支持utf-8格式 |
| - 门店门头照片 | store_header_copy | 是 | S（4512） | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo | 1、请上传门头正面照片（要求门店招牌、门框完整、清晰、可辨识）；若为停车场等无固定门头照片的经营场所，可上传岗亭/出入闸口。具体参考【指引文档】； 2、请填写通过《图片上传API》预先上传图片生成好的MediaID |
| - 店内环境照片 | store_indoor_copy | 是 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5 | 1、请上传门店内部环境照片（可辨识经营内容）。若为停车场等无固定门头的经营场所，可上传停车场内部照片。具体参考【指引文档】； 2、请填写通过《图片上传API》预先上传图片生成好的MediaID |
| 经营许可证 | special_operation_list | 否 | C | 1、填写特殊行业的经营许可证信息 2、最多填写支持5个行业 |
|
| - 行业类目id | category_id | 是 | I | 示例值：100 | 参看微信支付提供的《特殊行业id对照表》 |
| - 行业经营许可证资质照片 | operation_copy_list | 否 | C | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Sc | 1、请根据特殊行业id对照表内指引，仅当所选择的行业为【必填经营许可证】的行业时，才需上传该项资料 2、请填写通过《图片上传API》预先上传图片生成好的MediaID 3、每个行业最多支持5张资质照片 |
| 金融机构许可证 | finance_institution_info | 否 | 当主体是金融机构时，必填 | ||
| - 金融机构类型 | finance_type | 是 | S | 示例值：BANK_AGENT | 金融机构类型需与营业执照/登记证书上一致，可参考选择金融机构指引。 BANK_AGENT：银行业, 适用于商业银行、政策性银行、农村合作银行、村镇银行、开发性金融机构等 PAYMENT_AGENT：支付机构, 适用于非银行类支付机构 INSURANCE：保险业, 适用于保险、保险中介、保险代理、保险经纪等保险类业务 TRADE_AND_SETTLE：交易及结算类金融机构, 适用于交易所、登记结算类机构、银行卡清算机构、资金清算中心等 OTHER：其他金融机构, 适用于财务公司、信托公司、金融资产管理公司、金融租赁公司、汽车金融公司、贷款公司、货币经纪公司、消费金融公司、证券业、金融控股公司、股票、期货、货币兑换、小额贷款公司、金融资产管理、担保公司、商业保理公司、典当行、融资租赁公司、财经咨询等其他金融业务 |
| - 金融机构许可证图片 | finance_license_pics | 是 | C | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgV | 1、照片应正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS； 2、上传彩色照片、彩色扫描件，复印件需加盖公章鲜章。 3、水印仅限于微信支付业务相关。 4、根据所属金融机构类型的许可证要求提供，详情查看金融机构指引。 5、请提供为“申请商家主体”所属的许可证，可授权使用总公司/分公司的特殊资质。 6、最多可上传5张照片，请填写通过《图片上传API》预先上传图片生成好的MediaID。 |
法人身份信息：identification_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 证件持有人类型 | id_holder_type | 否 | S | 示例值：LEGAL | 主体类型为政府机关、事业单位时选传： （1）若上传的是法人证件，则不需要上传该字段。 (2）若因特殊情况，无法提供法人证件时，可上传经办人。 （经办人：经商户授权办理微信支付业务的人员，授权范围包括但不限于签约，入驻过程需完成账户验证）。 2. 主体类型为企业、个体户、社会组织时，默认为经营者/法人，不需要上传该字段。LEGAL：经营者/法人 SUPER：经办人 |
| 证件类型 | identification_type | 否 | S | 示例值：IDENTIFICATION_TYPE_IDCARD | 1、当证件持有人类型为法人时，填写。其他情况，无需上传。 2、个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、小微仅支持中国大陆居民-身份证类型。 枚举值：IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT：中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证 IDENTIFICATION_TYP |
| 法定代表人说明函 | authorize_letter_copy | 否 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、当证件持有人类型为经办人时，必须上传。其他情况，无需上传。 2、若因特殊情况，无法提供法定代表人证件时，请参照《示例图》打印法定代表人说明函，全部信息需打印，不支持手写商户信息，并加盖公章。 3、可上传1张图片，请填写通过《图片上传API》预先上传图片生成好的MediaID。 |
| 证件姓名 | identification_name | 否 | S(100) | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、当证件持有人类型为法人时，请填写法人证件上的姓名。其他情况，无需上传。 2、长度为2-100个字符 3、前后不能有空格、制表符、换行符 4、不能仅含数字、特殊字符 5、仅能填写数字、英文字母、汉字及特殊字符 6、该字段需进行加密处理，加密方法详见《敏感信息加密说明》 |
| 证件号码 | identification_number | 否 | S(100) | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、当证件持有人类型为法人时，请填写法人证件上的证件号码。其他情况，无需上传。 2、该字段需进行加密处理，加密方法详见《敏感信息加密说明》 3、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码，号码规范如下：身份证（限中国大陆居民)：17位数字+1位数字 |
| 证件有效日期 | identification_valid_date | 否 | S | 示例值：["2017-10-28","forever"] | 1、日期格式应满足合法的YYYY-MM-DD格式，参见示例值 2、若证件有效期为长期，请填写：forever。 3、开始时间不能大于等于当前日期，结束时间需大于开始时间。 |
| 证件居住地址 | identification_address | 否 | S(128) | 示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4i | 1、主体类型为企业时，需要填写。其他主体类型，无需上传。2、请按照身份证住址填写，如广东省深圳市南山区xx路xx号xx室 3、长度为4-128个字符 4、前后不能有空格、制表符、换行符 5、不能仅含数字、特殊字符 6、仅能填写数字、英文字母、汉字及特殊字符 7、仅支持utf-8格式 8、该字段需进行加密处理，加密方法详见《敏感信息加密说明》 |
| 证件正面照片 | identification_front_copy | 否 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIT | 当证件持有人类型为法人时，请上传法人证件的正面照片。其他情况，无需上传。1、证件类型不为“身份证””时，上传证件正面照片；若法人证件类型为身份证，请上传人像面照片 2、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 3、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证），见【指引文档】 4、可上传1张图片，请填写通过《图片上传API》预先上传图片生成好的MediaID |
| 证件反面照片 | identification_back_copy | 否 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIT | 当证件持有人类型为法人时，请上传法人证件的反面照片。其他情况，无需上传。 1、若证件类型为往来通行证、外国人居留证、港澳居住证、台湾居住证时，上传证件反面照片。 2、若证件类型为护照，无需上传反面照片。 3、若法人证件类型为身份证，请上传国徽面照片 4、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 5、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证），见【指引文档】 6、可上传1张图片，请填写通过《图片上传API》预先上传图片生成好的MediaID> |
| 经营者/法人是否为受益人 | owner | 否 | B | 示例值：false | 主体类型为企业时，需要填写： 1、若经营者/法人是最终受益人，则填写：true。 2、若经营者/法人不是最终受益人，则填写：false。 |
最终受益人信息列表(UBO)：ubo_info_list
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 证件类型 | ubo_id_doc_type | 是 | S | 示例值：IDENTIFICATION_TYPE_IDCARD | 请填写受益人的证件类型。枚举值： IDENTIFICATION_TYPE_IDCARD：中国大陆居民-身份证 IDENTIFICATION_TYPE_OVERSEA_PASSPORT：其他国家或地区居民-护照 IDENTIFICATION_TYPE_HONGKONG_PASSPORT：中国香港居民-来往内地通行证 IDENTIFICATION_TYPE_MACAO_PASSPORT：中国澳门居民-来往内地通行证 IDENTIFICATION_TYPE_TAIWAN_PASSPORT：中国台湾居民-来往大陆通行证 IDENTIFICATION_TYPE_FOREIGN_RESIDENT：外国人居留证 IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT：港澳居民证 IDENTIFICATION_TYPE_TAIWAN_RESIDENT：台湾居民证 |
| 证件正面照片 | ubo_id_doc_copy | 是 | S | 示例值：jTpGmxUXqRTvDujqhThn4Re | 1、请上传受益人证件的正面照片。 2、若证件类型为身份证，请上传人像面照片。 3、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 4、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证），见【指引文档】 5、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。 |
| 证件反面照片 | ubo_id_doc_copy_back | 否 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、请上传受益人证件的正面照片。 2、若证件类型为身份证，请上传人像面照片。 3、正面拍摄、清晰、四角完整、无反光或遮挡；不得翻拍、截图、镜像、PS。 4、请上传彩色照片or彩色扫描件，复印件需加盖公章鲜章，可添加“微信支付”相关水印（如微信支付认证），见【指引文档】 5、可上传1张图片，请填写通过图片上传API预先上传图片生成好的MediaID。 |
| 证件姓名 | ubo_id_doc_name | 是 | S(200) | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、长度为2-100个字符 2、前后不能有空格、制表符、换行符 3、不能仅含数字、特殊字符 4、仅能填写数字、英文字母、汉字及特殊字符 5、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) |
| 证件号码 | ubo_id_doc_number | 是 | S | 示例值：0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7Scmh | 1、可传身份证、来往内地通行证、来往大陆通行证、护照等证件号码，号码规范如下： 身份证（限中国大陆居民)：17位数字+1位数字 |
| 证件居住地址 | ubo_id_doc_address | 是 | S(128) | 示例值：pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4i | 1、请按照身份证住址填写，如广东省深圳市南山区xx路xx号xx室 2、长度为4-128个字符 3、前后不能有空格、制表符、换行符 4、不能仅含数字、特殊字符 5、仅能填写数字、英文字母、汉字及特殊字符 6、仅支持utf-8格式 7、该字段需进行加密处理，加密方法详见敏感信息加密说明。(提醒：必须在HTTP头中上送Wechatpay-Serial) |
| 证件有效期开始时间 | ubo_period_begin | 是 | S | 示例值：2019-06-06 | 1、日期格式应满足合法的YYYY-MM-DD格式 2、开始时间不能小于1900-01-01 3、开始时间不能大于等于当前日 |
| 证件有效期结束时间 | ubo_period_end | 是 | S | 示例值：2019-06-06 | 1、日期格式应满足合法的YYYY-MM-DD格式 2、开始时间不能小于1900-01-01 3、开始时间不能大于等于当前日 |
- 支付宝参数:
商户认证信息：merchantConfirmInfo
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 联系人信息 | contact_person_info | 是 | 联系人信息 | ||
| 主体信息 | auth_identity_info | 是 | 主体信息 | ||
| 法人身份信息 | legal_person_info | 是 | 法人身份信息 | ||
| 受益人信息 | legal_person_info | 否 | 受益人信息。如下情况时必填：主体类型为企业，且其法人/经营者不为最终受益所有人（即：legal_person_info内的is_benefit_person=false）；其他情况不填。 | ||
| 补充材料 | extra_credentials | 否 | 补充材料 |
联系人信息：contact_person_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 联系人姓名 | contact_name | 是 | S(64） | 张三 | |
| 联系人手机号 | contact_phone_no | 否 | S(32) | - | 联系人手机,该字段需进行加密处理。 |
| 联系人身份证件号。 | contact_card_no | 是 | S(64) | 233330199001010001 | 可传身份证、港澳居民来往内地通行证、港澳居民居住证、台湾居民来往大陆通行证、台湾居民居住证、护照、外国人永久居住证等证件号码。若传身份证，需保证18位，且英文字母大写,该字段需进行加密处理。 |
| 联系人证件类型 | contact_cert_type | 否 | S(128) | RESIDENT | 联系人证件类型， 枚举值：中国大陆居民-身份证(RESIDENT)、其他国家或地区居民-护照(PASSPORT)、中国港澳居民-来往内地通行证(PASSPORT_HK_MO)、中国台湾居民-来往大陆通行证(PASSPORT_TWN)、港澳居民居住证（RESIDENCE_PERMIT_HM）、台湾居民居住证（RESIDENCE_PERMIT_TW）、外国人永久居住证（PERMANENT_RESIDENCE_FOREIGNER）。个体户/企业/事业单位/社会组织：可选择任一证件类型。小微商户仅支持身份证类型 枚举值 居民身份证: RESIDENT 港澳居民(往来大陆通行证): PASSPORT_HK_MO 台湾居民(往来大陆通行证): PASSPORT_TWN 护照: PASSPORT 港澳居民居住证: RESIDENCE_PERMIT_HM 台湾居民居住证: RESIDENCE_PERMIT_TW 外国人永久居住证: PERMANENT_RESIDENCE_FOREIGNER |
主体类型：auth_identity_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 主体类型 | identity_type | 是 | S(32) | ENTERPRISE | 枚举定义：企业(ENTERPRISE)、个体工商户(IND_BIZ)、事业单位(INST)、党政机关(GOV)、社会组织(ORG)、小微商户(MSE) |
| 是否金融机构 | is_financial_org | 否 | B | false | 金融机构信息，当主体为金融机构时，必填 |
| 金融机构信息 | financial_org_info | 否 | B | false | 金融机构信息，当主体为金融机构时，必填 |
| - 机构类型 | financial_org_type | 否 | S(32) | PAYMENT | 银行业(BANK)、支付机构(PAYMENT)、保险业(INSURANCE)、交易及结算类金融机构(SETTLE)、OTHER(OTHER) |
| - 金融机构许可证图片 | financial_org_cert_img | 否 | C | [“a5d373f6-3e79-405f-9993-fb7ea051c372.jpg”] | 金融机构许可证图片，最多五张（使用图片上传接口） |
| 证书类型 | certificate_type | 否 | S(32) | BUSINESS_CERT | 主体类型为企业/个体户/政府机关/事业单位/社会组织时，必填；证照类型：营业执照(BUSINESS_CERT)/登记证书(REGISTER_CERT)主体为政府机关/事业单位/社会组织时，填登记证书；主体类型为企业/个体户时，填营业执照； |
| 证件信息 | certificate_info | 否 | S(32) | 体类型为企业/个体户/政府机关/事业单位/社会组织时，必填 | |
| - 证件类型 | cert_type | 否 | S(32) | SOCIAL_ORG_LEGAL | 登记证书类型时必填，枚举： 统一社会信用代码证书（UNIT_SOCIAL_CREDIT）、慈善组织公开募捐资格证书（CHARITY_ORG_SOLICIT），社会团体法人登记证书（SOCIAL_ORG_LEGAL），民办非企业单位登记证书（CIVIL_UN_ENT），基金会法人登记证书（FOUNDATION_LEGAL_PERSON），农民专业合作社法人营业执照（FARMERS_COOPERATE），宗教活动场所登记证（RELIGION_PLACES），其他证书/批文/证明（OTHER_REG_CERT） |
| - 证件编号 | cert_no | 否 | S(64) | 0000001 | |
| - 证照图片 | cert_image | 否 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 证照图片（使用图片上传接口） |
| - 证照法人姓名 | legal_person_name | 否 | S(64) | 李四 | |
| - 证照注册地址 | register_address | 否 | S(128） | 省杭州市西湖区xxx街道xxx门牌号 | |
| - 证照生效时间 | effect_time | 否 | S(32） | 1999-01-01 | |
| - 证照过期时间 | expire_time | 否 | S(32） | 2020-11-01 | 长期有效时传“forever” |
| 单位证明函照片 | employer_letter_img | 否 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 单位证明函照片（使用图片上传接口）主体类型为政府机关/事业单位时，单位证明函照片必填 |
| 辅助证明材料, | support_credentials | 否 | 辅助证明材料,主体类型为小微商户时，辅助证明材料信息必填 | ||
| - 小微商户经营类型 | merchant_type | 是 | S(32) | STORE | 小微商户经营类型，枚举值：门店场所（STORE）、流动经营（STALL) |
| - 门店名称 | store_name | 是 | S(64) | 门店名称 | 新新饭店 |
| - 门店省行政区号 | province_code | 是 | S(32) | 330100 | 门店省行政区号（数字) |
| - 门店省份 | province | 是 | S(32) | 浙江省 | 门店省份 |
| - 门店市行政区号 | city_code | 是 | S(32) | 3310303 | 门店市行政区号（数字） |
| - 门店省份 | city | 是 | S(32) | 杭州市 | 门店城市 |
| - 门店街道区号 | district_code | 是 | S(32) | 3310303 | 门店街道区号（数字） |
| - 门店街道 | district | 是 | S(32) | 西湖区留下街道 | 门店街道区号（数字） |
| - 门店详细地址 | store_address | 是 | S(32) | xxx街道xxx门牌号 | 门店场所填写门店详细地址，流动经营类型填“无” |
| - 门店门头照信息或摊位照 | store_door_img | 是 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 门店门头照信息或摊位照（使用图片上传接口） |
| - 门店店内照片或者摊位照侧面 | store_inner_img | 是 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 门店店内照片或者摊位照侧面（使用图片上传接口） |
| 经营许可证列表 | qualification_info_list | 否 | C | 3310303 | 经营许可证列表，填写特殊行业的经营许可证信息，一个主体最多5个行业 |
| - 行业类目编号 | mcc_code | 是 | S(32) | B0001 | 行业类目编号，支付宝商家行业二级类目code |
| - 行业经营许可证资质照片 | image_list | 是 | [“a5d373f6-3e79-405f-9993-fb7ea051c372.jpg”] | 行业经营许可证资质照片，一个行业类目下最多上传6张资质照片（使用图片上传接口） |
法人身份信息：legal_person_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 证件持有人类型 | legal_type | 否 | S(32) | LEGAL_PERSON | - 法人 LEGAL_PERSON- 经办人 AGENT_PERSON 主体类型为政府机关、事业单位时选传： （1）若上传的是法人证件，则不需要上传该字段。 （2）若因特殊情况，无法提供法人证件时，可上传经办人。 主体类型为企业、个体户、社会组织、小微商户时，默认为经营者/法人，不需要上传该字段。 |
| 证件类型 | card_type | 是 | S(32) | RESIDENT | 证件类型，枚举值： 中国大陆居民-身份证(RESIDENT)、其他国家或地区居民-护照(PASSPORT)、中国港澳居民-来往内地通行证(PASSPORT_HK_MO)、中国台湾居民-来往大陆通行证(PASSPORT_TWN)、港澳居民居住证（RESIDENCE_PERMIT_HM）、台湾居民居住证（RESIDENCE_PERMIT_TW）、外国人永久居住证（PERMANENT_RESIDENCE_FOREIGNER）。个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、小微商户仅支持身份证类型。 |
| 法人姓名 | person_name | 是 | S(64) | 李四 | |
| 证件号码 | card_no | 是 | S(64) | 233330199001010001 | 1、该字段需进行加密处理 |
| 证件生效时间 | effect_time | 是 | S(32) | 1999-01-01 | |
| 证件过期时间 | expire_time | 是 | S(32) | 1999-01-01 | 长期有效时传“forever” |
| 法人/经营者证件正面照 | card_front_img | 是 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 法人/经营者证件正面照（使用图片上传接口返回的image_id） 证件过期时间 |
| 法人/经营者证件反面照 | card_back_img | 是 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 法人/经营者证件反面照（使用图片上传接口返回的image_id） 证件过期时间 |
| 授权函照片 | auth_letter_img | 否 | S(64) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 授权函照片（使用图片上传接口的image_id）。当证件类型为身份证时，此字段必传；当证件类型为非身份证时，此字段非必传 |
| 经营者/法人是否为受益人 | is_benefit_person | 否 | B | true |
受益人信息：benefit_person_info
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 受益人姓名 | person_name | 是 | S(64) | 张三 | |
| 证件号码 | card_no | 是 | S(64) | 233330199001010001 | 1、该字段需进行加密处理 |
| 证件类型 | card_type | 是 | S(32) | RESIDENT | 枚举值：中国大陆居民-身份证(RESIDENT)、其他国家或地区居民-护照(PASSPORT)、中国港澳居民-来往内地通行证(PASSPORT_HK_MO)、中国台湾居民-来往大陆通行证(PASSPORT_TWN)、港澳居民居住证（RESIDENCE_PERMIT_HM）、台湾居民居住证（RESIDENCE_PERMIT_TW）、外国人永久居住证（PERMANENT_RESIDENCE_FOREIGNER）。个体户/企业/事业单位/社会组织：可选择任一证件类型，政府机关、小微商户仅支持身份证类型。 |
| 证件生效时间 | effect_time | 是 | S(32) | 1999-01-01 | 证件生效时间 |
| 证件过期时间 | expire_time | 是 | S(32) | 1999-01-01 | 长期有效时传“forever” |
| 受益人证件正面照 | card_front_img | 是 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 法人/经营者证件正面照（使用图片上传接口返回的image_id） |
| 受益人证件反面照 | card_back_img | 否 | S(256) | a5d373f6-3e79-405f-9993-fb7ea051c372.jpg | 法人/经营者证件反面照（使用图片上传接口的image_id）。当证件类型为身份证时，此字段必传；当证件类型为非身份证时，此字段非必传 |
补充材料：extra_credentials
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 待确认商户号列表 | smid_list | 否 | S(512) | [“2088000000000001”] | 待确认商户号列表，最多20个 |
- 返回
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 代理商商户号 | agentMerId | 否 | S(16) | 100000 | 宝付支付分配的商户号 |
| 代理商终端号 | agentTerId | 否 | S(16) | 100000 | 宝付支付分配的终端号 |
| 商户号 | merId | 是 | S(16) | 100000 | 宝付支付分配的商户号 |
| 终端号 | terId | 是 | S(16) | 100000 | 宝付支付分配的终端号 |
| 报备类型 | reportType | 是 | E | 详见附录：《报备类型》 | |
| 认证状态 | confirmStatus | 是 | S(16) | 审核中：EDITING | 详见《二次认证状态》 |
| 认证单流水号 | bizNo | 否 | S(30) | 宝付业务流水号 | |
| 业务结果 | resultCode | 是 | S(16) | SUCCESS | 业务处理结果 |
| 错误代码 | errCode | 否 | S(32) | 当业务结果FAIL时，返回错误代码 | |
| 错误描述 | errMsg | 否 | S(128) | 当业务结果为FAIL时，返回错误描述 |
