概要描述:

请求参数(O-非必传 ,M-必传)

参数 参数名称 类型 参数说明 样例 可空
agent_no 服务商编号 String 服务商的编号，由SaaS平台分配，表示当前商户属于该服务商名下 88888888 M
merch_no 商户编号 String 商户编号 M
agent_apply_no 服务商申请单号 String 服务商申请单号 O
bankcard_data 结算卡信息 JSON 参考下表（结算卡信息：bankcard_data） M
image_data 商户资质图片信息 JSON 参考下表（资质图片信息：image_data） M
notify_url 通知地址 String 商户结算卡变更状态的通知地址 http://x.cn/shop/notice O
结算卡信息：bankcard_data
参数 参数名称 类型 参数说明 样例 可空
acc_type 结算卡类型 String 10A：对公 10B：对私 M
acc_name 结算卡户名 String M
idcard_no 持卡人身份证号 String acc_type=10B时必传 O
bank_code 结算卡开户银行联行号 取值详见附录：[银行代码 ] M
bank_name 结算卡开户银行网点名称 String acc_type=10A时必传(v1.08) O
acc_no 结算卡账号 String M
phone 结算卡预留手机号 String acc_type=10B时必传 O
bank_province_code 开户行网点 对应的省代码 String 取值详见附录：省市区代码 M
bank_city_code 开户行网点 对应的市代码 String 取值详见附录：省市区代码 M
image_modify_type 图片变更类型 String 非同名变更时必填，见下表 O
资质图片信息：image_data
参数 参数名称 类型 参数说明 样例 可空
A4 结算人银行卡正面图片id String 个体工商户必传 O
A28 开户许可证（基本户）图片id String O
A9999 非法人结算授权函图片id String 结算卡对私且持卡人身份证号与法人身份证不一致时必传 O
A37 商户信息变更表图片id String 商户信息变更表 O
A38 一般户印鉴卡图片id String 一般户印鉴卡 O
A39 单位结算卡图片id String 单位结算卡 O
A40 银行开户证明图片id String 银行开户证明 O
A2 法人身份证正面图片id String 法人身份证正面 O
A3 法人身份证反面图片id String 法人身份证反面 O
A41 法人银行卡正面图片id String 法人银行卡正面 O
A42 法人银行卡反面图片id String 法人银行卡反面 O
A35 结算人身份证正面图片id String 结算人身份证正面 O
A36 结算人身份证反面图片id String 结算人身份证反面 O
A44 结算人银行卡反面图片id String 结算人银行卡反面 O
A32 手持结算授权函图片id String 手持结算授权函 O
A1 营业执照图片id String 营业执照 O
A46 户籍更名证明图片id String 户籍更名证明 O
A9998 其他图片id String 其他 O
A9997 其他2图片id String 其他2 O
A49 对公户信息图片id String 对公户信息 O
A50 工商变更证明图片id String 工商变更证明 O
资质图片信息：image_modify_type
图片变更类型枚举值 含义 所需图片
10A 结算人由对私结算转对公结算 商户信息变更表，（开户许可证、一般户印鉴卡、单位结算卡、银行开户证明四选一必填）
10B 结算人由对公结算转法人对私结算 商户信息变更表，法人身份证正反面、法人银行卡正反面 、营业执照图片
10C 结算人由原对公账户结算首次变为非法人对私结算 商户信息变更表，结算人身份证正反面、结算人银行卡正反面、结算授权书、法人手持结算授权书、营业执照图片
10D 结算人由非法人结算变为法人结算 商户信息变更表，法人身份证正反面、法人银行卡正反面、营业执照图片
10E 营业执照在工商局进行了名称变更 商户信息变更表，营业执照、变更后的对公户信息、对公户信息图片、工商变更证明
10F 结算人在公安局备案更名 商户信息变更表，户籍更名证明、结算人的身份证正反面、结算人的银行卡正反卖面、结算授权书、法人手持结算授权书
10G 结算人由法人结算变为非法人结算的（非法人之间变更） 商户信息变更表，结算人身份证正反面、结算人银行卡正反面、结算授权书、法人手持结算授权书、营业执照图片

请求示例:

{
    "agent_no": "11010200097",
    "agent_apply_no": "148972558691",
    "merch_no": "833226358120003",
    "notify_url": "https://www.baidu.com",
    "bankcard_data": {
        "acc_name": "艾飞",
        "bank_code": "105100000017",
        "acc_type": "10B",
        "phone": "18645178181",
        "acc_no": "6217000010044116492",
        "bank_name": "西直门支行",
        "bank_city_code": "110100",
        "idcard_no": "21010119900324007X",
        "bank_province_code": "110000"
    },
    "image_data": {
        "A28": "",
        "A9999": "c96650cbfd914754ac6cff24be4b89b3",
        "A4": ""
    },
    "accessid": "cpostest",
    "sign": "A2587279043A598D1BC39E37D78ACFC2"
}

返回参数说明:

参数 参数名称 类型 参数说明 样例 可空
return_code 返回码 int 10000：成功 其他：失败 M
return_msg 错误消息 String 当return_code不为10000时有值 O
apply_no 申请单编号 String 当return_code=10000时有值 O
settlement_cycle 结算周期 String 修改结算卡后结算周期 D1 O

返回示例:

{
    "apply_no": "200324132235396280367202",
    "return_code": 10000,
    "sign": "A5503002FC11A79E3309EB6C6D9712AE"
    "settlement_cycle": "D1"
}
文档更新时间: 2026-03-04 17:51   作者：王金晶