主题
商户基本信息修改
接口描述
- 接入方通过该接口进行商户基础信息的修改。
- 小微商户：可变更法人身份证信息(身份证号码不可变更)，商户简称，经营地址信息等
- 个体工商户：可变更法人身份证信息(身份证号码不可变更)，营业执照信息(营业执照号码不可变更)，商户简称，经营地址信息等
- 企业工商户：可变更法人身份证信息(身份证号码可变更)，营业执照信息(营业执照号码不可变更)，商户简称，经营地址信息等
请求URL
/merchant/baseModify
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS241113000204 |
| requestNo | 是 | string | 32 | 接入方请求流水号 | 123456789 |
| legalCertType | 否 | string | 32 | 法人证件类型 ID_CARD-身份证；PASSPORT-护照；HK_MACAO_PERMIT-港澳通行证；TW_PERMIT-台胞证；FOREIGN_PERMANENT-外国人永久居住证； 修改法人信息时必填 | |
| legalPhoneNo | 否 | string | 64 | 法人手机号(需要AES加密) ，修改法人信息时必填 | |
| legalName | 否 | string | 64 | 法人姓名(需要AES加密) ，修改法人信息时必填 | |
| legalCertNo | 否 | string | 64 | 法人身份证(需要AES加密)，修改法人信息时必填，小微与个体工商户需要与原信息保持一致 | |
| legalCertFrontUrl | 否 | string | 64 | 法人证件人脸照片 | |
| legalCertBackUrl | 否 | string | 64 | 法人证件国徽面照片 | |
| legalHandCertUrl | 否 | string | 64 | 法人手持身份证照片 | |
| legalCertAddress | 否 | string | 128 | 证件地址信息(需要AES加密) | |
| legalCertStartTime | 否 | string | 10 | 证件有效起始日期(yyyy-MM-dd) | 2024-01-01 |
| legalCertEndTime | 否 | string | 10 | 证件有效截止日期(yyyy-MM-dd)，如果是长期则传“长期” | 2050-01-01 |
| legalProvinceCode | 否 | string | 12 | 法人证件省份编码 | 310000 |
| legalCityCode | 否 | string | 12 | 法人证件城市编码 | 310100 |
| legalDistrictCode | 否 | string | 12 | 法人证件区县编码 | 310114 |
| legalEmail | 否 | string | 64 | 法人邮箱(需要AES加密) | |
| controllerCertType | 否 | string | 实控人证件类型 ID_CARD-身份证；PASSPORT-护照；HK_MACAO_PERMIT-港澳通行证；TW_PERMIT-台胞证；FOREIGN_PERMANENT-外国人永久居住证；实控人是法人的可不传 | ||
| controllerName | 否 | string | 64 | 实控人姓名(需要AES加密)，实控人是法人的可不传 | |
| controllerCertNo | 否 | string | 64 | 实控人证件号(需要AES加密)，实控人是法人的可不传 | |
| controllerPhoneNo | 否 | string | 64 | 实控人手机号(需要AES加密)，实控人是法人的可不传 | |
| controllerCertStarTime | 否 | string | 10 | 实控人证件有效起始时间，格式：yyyy-MM-dd，实控人是法人的可不传 | |
| controllerCertEndTime | 否 | string | 10 | 实控人证件有效截止时间，格式：yyyy-MM-dd,如果为长期则传“长期”，实控人是法人的可不传 | |
| controllerCertAddress | 否 | string | 128 | 实控人证件地址(需要AES加密)，实控人是法人的可不传 | |
| controllerCertFrontUrl | 否 | string | 64 | 实控人证件正面地址，实控人是法人的可不传 | |
| controllerCertBackUrl | 否 | string | 64 | 实控人证件反面地址，实控人证件类型为身份证时必传，实控人是法人的可不传 | |
| merchantBriefName | 否 | string | 64 | 商户简称 | 小卖部 |
| busiLicNo | 否 | string | 32 | 统一社会信用代码，修改营业执照信息时必填，需要与原营业执照号一致 | 102290017292 |
| busiLicName | 否 | string | 32 | 营业执照名称，企业与个体工商户必填 | xxx公司 |
| busiLicAddress | 否 | string | 32 | 商户地址，企业与个体工商户必填 | xxx路xx号xxx室 |
| busiLicStartTime | 否 | string | 10 | 营业执照有效期开始时间 | 2020-01-01 |
| busiLicEndTime | 否 | string | 10 | 营业执照有效期（结束时间），如果是长期或者无有效期则传“长期” | 2050-01-01 |
| busiLicPicUrl | 否 | string | 64 | 营业执照照片 | |
| busiProvinceCode | 否 | string | 32 | 营业执照地址所在省编码 | 310000 |
| busiCityCode | 否 | string | 32 | 营业执照地址所在市编码 | 310100 |
| busiDistrictCode | 否 | string | 32 | 营业执照地址所在区编码 | 310104 |
| compFrontPicUrl | 否 | string | 64 | 企业前台照片,修改营业执照信息时必传 | |
| compScenePicUrl | 否 | string | 64 | 企业场景照片,修改营业执照信息时必传 | |
| busiPermitName | 否 | string | 32 | 经营许可证名称 | |
| busiPermitNo | 否 | string | 32 | 经营许可证编号 | |
| busiPermitStartTime | 否 | string | 10 | 经营许可证有效期开始时间，格式：yyyy-MM-dd | |
| busiPermitEndTime | 否 | string | 10 | 经营许可证有效期结束时间，格式：yyyy-MM-dd,如果为长期则传“长期” | |
| busiPermitPicUrl | 否 | string | 10 | 经营许可证照片 | |
| supplementMaterials | 否 | string | 10 | 补充材料，多个补充材料用半角逗号隔开（最多10个），补充材料应先通过文件上传接口上传后获取文件名称 | fileName1,fileName2,fileName3 |
| beneficiaryInfo | 否 | string | 受益人信息列表的json数组字符串(需要AES加密) | ||
| - beneficiaryName | 是 | string | 64 | 受益所有人姓名 | |
| - benefitType | 是 | string | 32 | 受益人类型： OWNERSHIP_25_PERCENT:直接或间接拥有25%(含)以上股权或合伙权益 CONTROL_LEGAL_ENTITY:单独或者联合对法人组织进行实际控制 BENEFICIAL_25_PERCENT_SHARE:直接或者间接享有25%（含）以上收益权 SENIOR_MANAGEMENT:高级管理人员 | |
| - beneficiaryCertType | 是 | string | 32 | 受益所有人证件类型： ID_CARD-身份证；PASSPORT-护照；HK_MACAO_PERMIT-港澳通行证；TW_PERMIT-台胞证；FOREIGN_PERMANENT-外国人永久居住证；USCC-统一社会信用代码； | |
| - beneficiaryCertNo | 是 | string | 64 | 受益所有人证件号 | |
| - beneficiaryCertStartTime | 是 | string | 64 | 受益所有人证件有效期开始时间(yyyy-MM-dd) | 2020-01-01 |
| - beneficiaryCertEndTime | 是 | string | 64 | 受益所有人证件有效期结束时间(yyyy-MM-dd),如果长期则传“长期” | 2025-01-01 |
| - beneficiaryCertAddress | 是 | string | 64 | 受益所有人证件地址 | |
| - beneficiaryPhoneNo | 是 | string | 64 | 受益所有人手机号 | |
| - beneficiaryCertFrontUrl | 是 | string | 64 | 受益所有人证件正面照片 | |
| - beneficiaryCertBackUrl | 是 | string | 64 | 受益所有人证件反面照片 | |
| contactName | 否 | string | 64 | 联系人姓名(需要AES加密) | |
| contactPhoneNo | 否 | string | 64 | 联系人手机号(需要AES加密) | |
| contactEmail | 否 | string | 64 | 联系人邮箱(需要AES加密) | |
| storeName | 否 | string | 30 | 店铺名称 | |
| storeCategory | 否 | string | 2 | 店铺类型，流动摊位-01,固定门店-02,线上店铺-03 | |
| storeAddress | 否 | string | 255 | 店铺详细地址 | |
| storeLongitude | 否 | string | 店铺地址经度 | ||
| storeLatitude | 否 | string | 店铺地址纬度 | ||
| storeCashierPicUrl | 否 | string | 64 | 收银台照片 | |
| storeHeadPicUrl | 否 | string | 64 | 门头照片 | |
| storeIndoorPicUrl | 否 | string | 64 | 店内照片 | |
| storeGoodsPicUrl | 否 | string | 64 | 商品照片 | |
| appImageUrl | 否 | string | 64 | APP首页截图照片 | |
| companyDomain | 否 | string | 128 | 企业官网 | |
| icp | 否 | string | 32 | icp备案号 | |
| videoUrl | 否 | string | 32 | 人脸认证视频链接 |
请求报文示例
json
{
"appId": "202408554212370909",
"requestNo": "123456789",
"contactEmail": "NFAud9j8HegfXnT2uZCVB3ehIXTJM1H4YRJRHuJzM9s=",
"contactName": "JRK97dTOVaSwU3smFZ2uUQ==",
"contactPhoneNo": "h6f9rFZAgtWiNqWzBIAZKw==",
"legalCertAddress": "bdkjGizwp6ZO+P3GmbCLGHF6NTd22QgxKFYLwHfsQopp2NpyWbXY2mBlj7hkblovoBkYtE77dsMKfIka84YH/SgyDQOjoGmYEAHcHiY2jyQ=",
"legalCertBackUrl": "PRI140d37bea52c4189b1685781a8b49653.png",
"legalCertEndTime": "2038-05-02",
"legalCertFrontUrl": "PRI2c7e3fe477a54e01a7efb7290cd9dc42.png",
"legalCertNo": "Lw178IM6/4jaQEpkDCbzHZqBUbML1LtR4Ew+YmcAQLo=",
"legalCertStartTime": "2018-05-02",
"legalCertType": "ID_CARD",
"legalCityCode": "330700",
"legalDistrictCode": "330703",
"legalEmail": "NFAud9j8HegfXnT2uZCVB3ehIXTJM1H4YRJRHuJzM9s=",
"legalName": "JRK97dTOVaSwU3smFZ2uUQ==",
"legalPhoneNo": "h6f9rFZAgtWiNqWzBIAZKw==",
"legalProvinceCode": "330000",
"merchantBriefName": "得动",
"merchantCategory": "T",
"outMerchantNo": "ZD000000000013",
"signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg==",
"storeAddress": "xx省xx市xx区xxx号",
"storeCashierPicUrl": "PRI77c3e4cb8a1749edbf7cdb56f71a0340.png",
"storeHeadPicUrl": "PRI2e54031ce5a74966a836753619169de9.png",
"storeIndoorPicUrl": "PRI7fe8f2161001466695a3f9966441e261.png",
"transDate": "1731486017900",
"transNonce": "879df171f3de481d825e1e185638ee22",
"videoUrl": "PRIefc2789caea54cc7bb3560e7e459d29c.png"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"transDate": "1731486017900",
"transNonce": "879df171f3de481d825e1e185638ee22",
"signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述