API接口文档
首页
支付业务
首页
支付业务
  • 说明

    • 概述
    • 接口说明
  • JSAPI支付

    • 二维码支付
    • JSAPI支付
    • JSAPI调起支付
    • JSAPI支付通知
    • 付款码支付
  • 交易管理

    • 交易查询
    • 申请退款
    • 退款查询
    • 统一交易通知
  • 商户进件
    • 进件概述
    • 图片上传
    • 进件申请
    • 进件状态查询
    • 进件信息修改
    • 认证状态查询
    • MCC行业编码
    • 创建自定义表单定义
    • 申请固定二维码

进件信息修改

接口说明

进件信息修改接口用于修改已提交的商户进件申请信息。主要使用场景:

  • 审核驳回后,根据驳回原因修改相关资料后重新提交
  • 商户信息变更时,更新商户基本信息

请求地址

【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)营业执照照片 IDmedia_id_license
license_number否String(32)注册号/统一社会信用代码91310000XXXXXXXXXX
license_address否String(128)营业执照注册地址上海市XX区XX路XX号
period_begin否String(10)营业执照有效期开始日期,格式:YYYY-MM-DD2020-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-DD2015-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)门店门头照片 IDmedia_id_entrance
indoor_pic否String(64)门店内部照片 IDmedia_id_indoor
cashier_pic否String(64)收银台照片 IDmedia_id_cashier

互联网网站信息

参数必填类型说明示例值
domain否String(256)网站域名(需 ICP 备案)https://www.example.com
web_authorisation否String(64)网站授权函照片 IDmedia_id_auth
icp_license_pic否String(64)ICP 许可证或公众号主体信息截图 IDmedia_id_icp

结算信息

参数必填类型说明示例值
settlement_type否String(16)结算类型,当前仅支持 D1D1
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)银行账户证明照片 IDmedia_id_bank

补充材料(可选)

参数必填类型说明示例值
legal_person_commitment否String(64)法定代表人开户承诺函照片 IDmedia_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)附加信息(异步通知原样回传)商户附加备注

请求示例

示例1:审核驳回后修改证件照片重新提交

{
  "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"
}

示例2:通过 business_code 定位并修改多项信息

{
  "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:ss2023-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银行账号格式错误

注意事项

  1. 允许修改的状态:
    • REJECTED(审核驳回)- 根据驳回原因修改后重新提交
    • SUBMITTED(已提交)- 在审核前可以修改补充信息
  2. 不允许修改的状态:
    • AUDITING(审核中)- 正在审核处理中
    • APPROVED(审核通过)- 已审核通过,需要走其他流程
  3. applyment_id 与 business_code 二选一,用于定位待修改的进件申请单
  4. 仅需传递待修改字段,未传字段保持原值不变;business_code 不允许修改
  5. 修改后会自动重新提交审核,状态变更为 SUBMITTED
  6. 如需更换证件图片,需先调用图片上传接口获取新的 media_id
  7. 修改提交后,会通过 notify_url 异步通知审核结果
  8. 商户名称、营业执照编码、法人信息等关键信息修改需重新审核资质
Prev
进件状态查询
Next
认证状态查询