进件状态查询

接口说明

进件状态查询接口用于查询已提交的商户进件申请的审核状态和结果。提交进件申请后，可通过此接口实时查询审核进度。

请求地址

【POST】/pay/applyment/query

业务参数

参数必填类型说明示例值
applyment_id条件String(64)进件申请单号（通过进件申请接口获取）
与 business_code 二选一		2000002124775691
business_code条件String(124)业务申请编号（submit 接口传入）
与 applyment_id 二选一		APPLY_1900013511_10000

请求示例

{
  "applyment_id": "2000002124775691"
}

通过 business_code 查询

{
  "business_code": "APPLY_1900013511_10000"
}

返回结果

参数必填类型说明示例值
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 审核中
APPROVED 审核通过
REJECTED 审核驳回		AUDITING
merchant_no否String(32)商户号（审核通过后返回）1234567890
merchant_name否String(128)商户名称（审核通过后返回）上海XX科技有限公司
merchant_shortname否String(64)商户简称（审核通过后返回）XX科技
reject_reason否String(256)驳回原因（审核驳回时返回）身份证照片不清晰，请重新上传
submit_time是String(19)提交时间，格式：YYYY-MM-DD HH:mm:ss2023-12-01 10:30:00

说明： 接口返回 submit 接口提交的所有业务数据（不含内部字段如 developer_id、id、create_time、update_time）

返回示例

审核中

{
  "code": "000000",
  "message": "查询成功",
  "applyment_id": "2000002124775691",
  "business_code": "APPLY_1900013511_10000",
  "status": "AUDITING",
  "subject_type": "ENTERPRISE",
  "merchant_name": "上海XX科技有限公司",
  "merchant_shortname": "XX科技",
  "license_copy": "media_id_license",
  "license_number": "91310000XXXXXXXXXX",
  "license_address": "上海市XX区XX路XX号",
  "period_begin": "2020-01-01",
  "period_end": "2030-12-31",
  "id_doc_type": "IDCARD",
  "legal_person": "张三",
  "id_doc_front": "media_id_doc_front",
  "id_doc_back": "media_id_doc_back",
  "id_doc_name": "张三",
  "id_doc_number": "310101199001011234",
  "id_doc_address": "上海市XX区XX路XX号",
  "id_doc_period_begin": "2015-01-01",
  "id_doc_period_end": "2035-01-01",
  "contact_type": "LEGAL",
  "contact_name": "李四",
  "contact_id_doc_type": "IDCARD",
  "contact_id_number": "310101199001011234",
  "mobile_phone": "13800138000",
  "service_phone": "4001234567",
  "mcc_code": "5411",
  "business_scope": "软件开发、技术服务",
  "sales_scenes_type": ["SALES_SCENES_STORE"],
  "biz_store_name": "XX旗舰店",
  "biz_address_code": "310101",
  "biz_store_address": "上海市XX区XX路XX号XX大厦10楼",
  "store_entrance_pic": "media_id_entrance",
  "indoor_pic": "media_id_indoor",
  "cashier_pic": "media_id_cashier",
  "settlement_type": "D1",
  "bank_account_type": "CORPORATE",
  "account_name": "上海XX科技有限公司",
  "account_bank": "工商银行",
  "bank_address_code": "310100",
  "bank_branch_id": "102290026507",
  "bank_name": "工行上海分行XX支行",
  "account_number": "6222021001122334455",
  "bank_account_pic": "media_id_bank",
  "notify_url": "https://example.com/notify",
  "attach": "商户附加备注",
  "submit_time": "2023-12-01 10:30:00"
}

审核通过

{
  "code": "000000",
  "message": "查询成功",
  "applyment_id": "2000002124775691",
  "business_code": "APPLY_1900013511_10000",
  "status": "APPROVED",
  "merchant_no": "1234567890",
  "merchant_name": "上海XX科技有限公司",
  "merchant_shortname": "XX科技",
  "subject_type": "ENTERPRISE",
  "license_copy": "media_id_license",
  "license_number": "91310000XXXXXXXXXX",
  "license_address": "上海市XX区XX路XX号",
  "period_begin": "2020-01-01",
  "period_end": "2030-12-31",
  "id_doc_type": "IDCARD",
  "legal_person": "张三",
  "id_doc_front": "media_id_doc_front",
  "id_doc_back": "media_id_doc_back",
  "id_doc_name": "张三",
  "id_doc_number": "310101199001011234",
  "id_doc_address": "上海市XX区XX路XX号",
  "id_doc_period_begin": "2015-01-01",
  "id_doc_period_end": "2035-01-01",
  "contact_type": "LEGAL",
  "contact_name": "李四",
  "contact_id_doc_type": "IDCARD",
  "contact_id_number": "310101199001011234",
  "mobile_phone": "13800138000",
  "service_phone": "4001234567",
  "mcc_code": "5411",
  "business_scope": "软件开发、技术服务",
  "sales_scenes_type": ["SALES_SCENES_STORE"],
  "biz_store_name": "XX旗舰店",
  "biz_address_code": "310101",
  "biz_store_address": "上海市XX区XX路XX号XX大厦10楼",
  "store_entrance_pic": "media_id_entrance",
  "indoor_pic": "media_id_indoor",
  "cashier_pic": "media_id_cashier",
  "settlement_type": "D1",
  "bank_account_type": "CORPORATE",
  "account_name": "上海XX科技有限公司",
  "account_bank": "工商银行",
  "bank_address_code": "310100",
  "bank_branch_id": "102290026507",
  "bank_name": "工行上海分行XX支行",
  "account_number": "6222021001122334455",
  "bank_account_pic": "media_id_bank",
  "notify_url": "https://example.com/notify",
  "attach": "商户附加备注",
  "submit_time": "2023-12-01 10:30:00"
}

审核驳回

{
  "code": "000000",
  "message": "查询成功",
  "applyment_id": "2000002124775691",
  "business_code": "APPLY_1900013511_10000",
  "status": "REJECTED",
  "subject_type": "ENTERPRISE",
  "merchant_name": "上海XX科技有限公司",
  "merchant_shortname": "XX科技",
  "license_copy": "media_id_license",
  "license_number": "91310000XXXXXXXXXX",
  "license_address": "上海市XX区XX路XX号",
  "period_begin": "2020-01-01",
  "period_end": "2030-12-31",
  "id_doc_type": "IDCARD",
  "legal_person": "张三",
  "id_doc_front": "media_id_doc_front",
  "id_doc_back": "media_id_doc_back",
  "id_doc_name": "张三",
  "id_doc_number": "310101199001011234",
  "id_doc_address": "上海市XX区XX路XX号",
  "id_doc_period_begin": "2015-01-01",
  "id_doc_period_end": "2035-01-01",
  "contact_type": "LEGAL",
  "contact_name": "李四",
  "contact_id_doc_type": "IDCARD",
  "contact_id_number": "310101199001011234",
  "mobile_phone": "13800138000",
  "service_phone": "4001234567",
  "mcc_code": "5411",
  "business_scope": "软件开发、技术服务",
  "sales_scenes_type": ["SALES_SCENES_STORE"],
  "biz_store_name": "XX旗舰店",
  "biz_address_code": "310101",
  "biz_store_address": "上海市XX区XX路XX号XX大厦10楼",
  "store_entrance_pic": "media_id_entrance",
  "indoor_pic": "media_id_indoor",
  "cashier_pic": "media_id_cashier",
  "settlement_type": "D1",
  "bank_account_type": "CORPORATE",
  "account_name": "上海XX科技有限公司",
  "account_bank": "工商银行",
  "bank_address_code": "310100",
  "bank_branch_id": "102290026507",
  "bank_name": "工行上海分行XX支行",
  "account_number": "6222021001122334455",
  "bank_account_pic": "media_id_bank",
  "notify_url": "https://example.com/notify",
  "attach": "商户附加备注",
  "reject_reason": "证件照片不清晰,请重新上传",
  "submit_time": "2023-12-01 10:30:00"
}

错误码

错误码说明
000000成功
FAIL失败
APPLYMENT_NOT_FOUND进件申请单号不存在
PARAM_ERROR参数错误

状态说明

状态说明后续操作
SUBMITTED已提交等待审核，建议5分钟后查询
AUDITING审核中审核处理中，建议10分钟后再次查询
APPROVED审核通过可使用商户号进行支付业务
REJECTED审核驳回根据驳回原因修改后重新提交进件申请

注意事项

  1. 进件申请提交后，建议等待5分钟再查询，系统需要时间处理
  2. 审核时间一般为1-2个工作日，请耐心等待
  3. 审核驳回后，需要修改相关资料后重新提交进件申请
  4. 审核通过后，会返回商户号（merchant_no），该商户号用于后续的支付接口调用
  5. 建议通过异步通知（notify_url）接收审核结果，减少轮询查询频率