进件信息修改接口用于修改已提交的商户进件申请信息。主要使用场景:
- 审核驳回后,根据驳回原因修改相关资料后重新提交
- 商户信息变更时,更新商户基本信息
【POST】/pay/applyment/modify
字段命名与 submit 接口保持一致,仅需传递待修改字段,未传字段保持原值。
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| applyment_id | 条件 | String(64) | 进件申请单号 与 business_code 二选一 | 2000002124775691 |
| business_code | 条件 | String(124) | 业务申请编号 与 applyment_id 二选一 | APPLY_1900013511_10000 |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| subject_type | 否 | String | 主体类型
INDIVIDUAL 个体工商户
ENTERPRISE 企业(有限公司)
MICRO 小微商户(无营业执照) | ENTERPRISE |
| merchant_name | 否 | String(128) | 商户名称 个体工商户如无注册名称,按"个体户+经营者姓名"格式传入 | 上海XX科技有限公司 |
| merchant_shortname | 否 | String(64) | 商户简称 | XX科技 |
| license_copy | 否 | String(64) | 营业执照照片 ID | media_id_license |
| license_number | 否 | String(32) | 注册号/统一社会信用代码 | 91310000XXXXXXXXXX |
| license_address | 否 | String(128) | 营业执照注册地址 | 上海市XX区XX路XX号 |
| period_begin | 否 | String(10) | 营业执照有效期开始日期,格式:YYYY-MM-DD | 2020-01-01 |
| period_end | 否 | String(10) | 营业执照有效期结束日期,格式:YYYY-MM-DD,长期请填"长期" | 2030-12-31 |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| id_doc_type | 否 | String | 证件类型,取值同 submit 接口 | IDCARD |
| legal_person | 否 | String(100) | 经营者/法定代表人姓名 | 张三 |
| id_doc_front | 否 | String(64) | 证件正面照片 ID(身份证为人像面) | media_id_doc_front |
| id_doc_back | 否 | String(64) | 证件反面照片 ID(身份证为国徽面;护照等无反面不传) | media_id_doc_back |
| id_doc_name | 否 | String(100) | 证件姓名 | 张三 |
| id_doc_number | 否 | String(32) | 证件号码 | 310101199001011234 |
| id_doc_address | 否 | String(128) | 证件居住地址 | 上海市XX区XX路XX号 |
| id_doc_period_begin | 否 | String(10) | 证件有效期开始日期,格式:YYYY-MM-DD | 2015-01-01 |
| id_doc_period_end | 否 | String(10) | 证件有效期结束日期,格式:YYYY-MM-DD,长期请填"长期" | 2035-01-01 |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| contact_type | 否 | String | 联系人类型
LEGAL 经营者/法定代表人
SUPER 经办人 | LEGAL |
| contact_name | 否 | String(100) | 联系人姓名 | 李四 |
| contact_id_doc_type | 否 | String | 联系人证件类型,当 contact_type 为 SUPER 时必传 | IDCARD |
| contact_id_number | 否 | String(32) | 联系人证件号码,当 contact_type 为 SUPER 时必传 | 310101199001011234 |
| mobile_phone | 否 | String(32) | 联系手机号 | 13800138000 |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| service_phone | 否 | String(32) | 客服电话 | 4001234567 |
| mcc_code | 否 | String(32) | MCC 行业编码 | 5411 |
| business_scope | 否 | String(256) | 经营范围 | 软件开发、技术服务 |
| sales_scenes_type | 否 | Array[String] | 经营场景类型,可多选 | ["SALES_SCENES_STORE"] |
| biz_store_name | 否 | String(50) | 线下门店名称 | XX旗舰店 |
| biz_address_code | 否 | String(32) | 线下门店省市区编码(六位) | 310101 |
| biz_store_address | 否 | String(256) | 线下门店详细地址 | 上海市XX区XX路XX号XX大厦10楼 |
| store_entrance_pic | 否 | String(64) | 门店门头照片 ID | media_id_entrance |
| indoor_pic | 否 | String(64) | 门店内部照片 ID | media_id_indoor |
| cashier_pic | 否 | String(64) | 收银台照片 ID | media_id_cashier |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| domain | 否 | String(256) | 网站域名(需 ICP 备案) | https://www.example.com |
| web_authorisation | 否 | String(64) | 网站授权函照片 ID | media_id_auth |
| icp_license_pic | 否 | String(64) | ICP 许可证或公众号主体信息截图 ID | media_id_icp |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| settlement_type | 否 | String(16) | 结算类型,当前仅支持 D1 | D1 |
| bank_account_type | 否 | String | 账户类型
CORPORATE 对公账户
PERSONAL 经营者个人银行卡 | CORPORATE |
| account_name | 否 | String(128) | 开户名称 | 上海XX科技有限公司 |
| account_bank | 否 | String(32) | 开户银行 | 工商银行 |
| bank_address_code | 否 | String(32) | 开户银行省市编码(精确到市) | 310100 |
| bank_branch_id | 否 | String(32) | 开户银行联行号(与 bank_name 二选一) | 102290026507 |
| bank_name | 否 | String(128) | 开户银行全称(含支行,与 bank_branch_id 二选一) | 工行上海分行XX支行 |
| account_number | 否 | String(32) | 银行账号 | 6222021001122334455 |
| bank_account_pic | 否 | String(64) | 银行账户证明照片 ID | media_id_bank |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| legal_person_commitment | 否 | String(64) | 法定代表人开户承诺函照片 ID | media_id_commit |
| business_addition_pics | 否 | Array[String] | 补充材料照片 ID 数组(最多 5 张) | ["media_id_add"] |
| business_addition_msg | 否 | String(512) | 补充说明 | 资金来源:自有资金 |
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| notify_url | 否 | String(256) | 进件结果异步通知地址 | https://example.com/notify |
| attach | 否 | String(256) | 附加信息(异步通知原样回传) | 商户附加备注 |
{
"applyment_id": "2000002124775691",
"id_doc_front": "media_id_doc_front_new",
"id_doc_back": "media_id_doc_back_new",
"notify_url": "https://example.com/notify"
}
{
"business_code": "APPLY_1900013511_10000",
"merchant_shortname": "XX科技新名称",
"mobile_phone": "13900139001",
"account_number": "6222021001122334456",
"business_scope": "软件开发、技术服务、系统集成",
"store_entrance_pic": "media_id_entrance_new",
"indoor_pic": "media_id_indoor_new",
"cashier_pic": "media_id_cashier_new",
"notify_url": "https://example.com/notify",
"attach": "修改后重新提交"
}
| 参数 | 必填 | 类型 | 说明 | 示例值 |
|---|
| code | 是 | String(32) | 返回码,000000 表示成功 | 000000 |
| message | 是 | String(128) | 返回信息 | 修改成功,已重新提交审核 |
| applyment_id | 是 | String(64) | 进件申请单号 | 2000002124775691 |
| business_code | 是 | String(124) | 业务申请编号(原样回传) | APPLY_1900013511_10000 |
| status | 是 | String(32) | 进件状态
SUBMITTED 已提交
AUDITING 审核中 | SUBMITTED |
| modify_time | 是 | String(19) | 修改时间,格式:YYYY-MM-DD HH:mm:ss | 2023-12-02 10:30:00 |
{
"code": "000000",
"message": "修改成功,已重新提交审核",
"applyment_id": "2000002124775691",
"business_code": "APPLY_1900013511_10000",
"status": "SUBMITTED",
"modify_time": "2023-12-02 10:30:00"
}
| 错误码 | 说明 |
|---|
| 000000 | 成功 |
| FAIL | 失败 |
| APPLYMENT_NOT_FOUND | 进件申请单号或业务申请编号不存在 |
| PARAM_ERROR | 参数错误 |
| MEDIA_ID_INVALID | 图片 ID 无效或已过期 |
| MODIFY_NOT_ALLOWED | 不允许修改(审核通过或审核中的申请) |
| LICENSE_NUMBER_INVALID | 营业执照编码格式错误 |
| ID_CARD_INVALID | 身份证号码格式错误 |
| MOBILE_INVALID | 手机号格式错误 |
| BANK_ACCOUNT_INVALID | 银行账号格式错误 |
- 允许修改的状态:
REJECTED(审核驳回)- 根据驳回原因修改后重新提交SUBMITTED(已提交)- 在审核前可以修改补充信息
- 不允许修改的状态:
AUDITING(审核中)- 正在审核处理中APPROVED(审核通过)- 已审核通过,需要走其他流程
applyment_id 与 business_code 二选一,用于定位待修改的进件申请单- 仅需传递待修改字段,未传字段保持原值不变;
business_code 不允许修改 - 修改后会自动重新提交审核,状态变更为
SUBMITTED - 如需更换证件图片,需先调用图片上传接口获取新的 media_id
- 修改提交后,会通过
notify_url 异步通知审核结果 - 商户名称、营业执照编码、法人信息等关键信息修改需重新审核资质