用户管理类接口¶
user02 个人用户开户接口（页面版）¶
功能说明¶
用于在本平台系统下为个人用户开户。开户时，会做实名验证，请提供真实信息。若开通产品为企账通，请联系相关人员配置成开通支付账户，开户后会跳转密码设置页面，进行交易密码设置。若为APP+则开通非支付账户。
调用方式：页面返回（同步）
- 暂时只有身份证支持实名认证，并且只有身份证开户支持取现
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户姓名 | user_name | 变长50位String | 必须 | 用户的真实姓名 |
| 证件类型 | id_card_type | 变长2位String | 可选 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 22：其他 默认为10：身份证 |
| 身份证号 | id_card | 变长18位String | 必须 | 用户的证件号 |
| 手机号 | user_mobile | 定长11位String | 必须 | 用户的手机号 |
| 证件有效期开始日期 | valid_date_begin | 定长8位String | 可选 | 填写证件上有效期的开始日期，格式为：YYYYMMDD，例如：20290420 |
| 证件有效期日期 | valid_date_end | 定长8位String | 可选 | 填写证件上有效期的截止日期，格式为：YYYYMMDD，例如：20290420。长期时传：99991231 |
| 用户省份 | cust_prov | 定长4位String | 可选 | 用户省份，如上海0031 |
| 用户地区 | cust_area | 定长4位String | 可选 | 用户地区，如上海3100 |
| 住址 | cust_address | 变长250位String | 可选 | 填写证件上的住址 |
| 职业 | occupation | 定长2位String | 可选 | 见个人职业分类表 |
| 邮箱 | user_email | 变长40位String | 可选 | 用户的电子邮箱 |
| 页面类型 | request_type | 变长2位String | 可选 | P：桌面端页面 M：移动端页面 默认P桌面端 |
| 页面返回URL | ret_url | 变长128位的String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000–调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 子账号 | acct_id | 变长16位String | 必须 | 由汇付生成，用户的默认子账号 |
| 手机号 | user_mobile | 定长11位String | 必须 | 用户的手机号 |
| 本平台交易唯一标识号 | platform_seq_id | 变长20位string | 必须 | |
| 手续费金额 | fee_amt | 变长14位String | 可选 | 手续费金额，格式为###.00 |
| 手续费子账号 | fee_acct_id | 变长9位String | 可选 | 手续费扣款子账号 |
| 页面返回URL | ret_url | 变长128位的String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户私有域 | mer_priv | 变长128位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
返回码¶
| 返回码 | 返回描述 |
|---|---|
| 公共返回码 | |
| A40001 | 省份地区信息非法 |
| A40002 | 该用户已开户，身份证号已存在 |
| A40004 | 黑名单用户，开户失败 |
| A40005 | 身份校验失败 |
| A40006 | 身份证格式校验失败 |
| A40007 | 身份证末位校验失败 |
| A40008 | 手续费配置异常 |
| A40065 | 开户成功，密码设置失败 |
| A40085 | 该证件用户开户请求正在处理中,请稍后再试 |
页面展示¶
user01 个人用户开户接口（后台版）¶
功能说明¶
适用产品为app+，用于在本平台系统下为个人用户开户。开户时，会有实名验证，请提供真实信息。默认开通非支付账户，如果特殊需求，请跟联系相关人员配置成开通支付账户。
调用方式：后台返回（同步）
- 暂时只有身份证支持实名认证，并且只有身份证开户支持取现
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 用户姓名 | user_name | 变长50位String | 必须 | 用户的真实姓名 |
| 证件类型 | id_card_type | 变长2位String | 可选 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 22：其他 默认为10：身份证 |
| 身份证号 | id_card | 变长18位String | 必须 | 用户的证件号 |
| 手机号 | user_mobile | 定长11位String | 必须 | 用户的手机号 |
| 证件有效期开始日期 | valid_date_begin | 定长8位String | 可选 | 填写证件上有效期的开始日期，格式为：YYYYMMDD，例如：20290420 |
| 证件有效期日期 | valid_date_end | 定长8位String | 可选 | 填写证件上有效期的截止日期，格式为：YYYYMMDD，例如：20290420（长期传：99991231） |
| 用户省份 | cust_prov | 定长4位String | 可选 | 用户省份，如上海0031 |
| 用户地区 | cust_area | 定长4位String | 可选 | 用户地区，如上海3100 |
| 住址 | cust_address | 变长250位String | 可选 | 如果默认开通支付账户，该字段必填 |
| 职业 | occupation | 定长2位String | 可选 | 见个人职业分类表 |
| 邮箱 | user_email | 变长40位String | 可选 | 用户的电子邮箱 |
| 商户私有域 | mer_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 子账号 | acct_id | 变长16位String | 必须 | 由汇付生成，用户的默认子账号 |
| 手机号 | user_mobile | 定长11位String | 必须 | 用户的手机号 |
| 本平台交易唯一标识号 | platform_seq_id | 变长20位String | 必须 | |
| 手续费金额 | fee_amt | 变长14位String | 必须 | 手续费金额，格式为###.00 |
| 手续费子账号 | fee_acct_id | 变长9位String | 可选 | 手续费扣款子账号 |
| 商户私有域 | mer_priv | 变长128位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
user06 个人用户开户接口（信息采集页面版）¶
功能说明¶
用于在本平台系统下为个人用户开户。开户时，会做实名验证，请提供真实信息，如果上传身份证照片，则会进行身份证照片认证。若开通产品为企账通，请联系相关人员配置成开通支付账户
调用方式：页面返回（同步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 证件有效期开始日期 | valid_date_begin | 定长8位String | 可选 | 填写证件上有效期的开始日期，格式为：YYYYMMDD，例如：20290420 |
| 证件有效期日期 | valid_date_end | 定长8位String | 可选 | 填写证件上有效期的截止日期，格式为：YYYYMMDD，例如：20290420。长期时传：99991231 |
| 用户省份 | cust_prov | 定长4位String | 可选 | 用户省份，如上海0031 |
| 用户地区 | cust_area | 定长4位String | 可选 | 用户地区，如上海3100 |
| 住址 | cust_address | 变长250位String | 可选 | 填写证件上的住址 |
| 职业 | occupation | 定长2位String | 可选 | 见个人职业分类表 |
| 邮箱 | user_email | 变长40位String | 可选 | 用户的电子邮箱 |
| 页面类型 | request_type | 变长2位String | 可选 | M：移动端页面 不填默认移动端页面 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 身份证图片校验标识 | cert_check_flag | 定长1位String | 可选 | 1：开启身份证图片强制校验 默认不开启 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000–调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 子账号 | acct_id | 变长16位String | 必须 | 由汇付生成，用户的默认子账号 |
| 本平台交易唯一标识号 | platform_seq_id | 变长20位String | 必须 | |
| 页面返回URL | ret_url | 变长128位String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长128位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回码¶
| 返回码 | 返回描述 |
|---|---|
| 公共返回码 | |
| A40001 | 省份地区信息非法 |
| A40002 | 该用户已开户，身份证号已存在 |
| A40004 | 黑名单用户，开户失败 |
| A40005 | 身份校验失败 |
| A40006 | 身份证格式校验失败 |
| A40007 | 身份证末位校验失败 |
| A40008 | 手续费配置异常 |
| A40065 | 开户成功，密码设置失败 |
| A40085 | 该证件用户开户请求正在处理中,请稍后再试 |
页面展示¶
corp01 企业开户申请（后台版）¶
功能说明¶
适用产品为企账通/app+，用于在本平台系统下为企业用户开户。该接口需要配合文件上传接口使用，先调用文件上传接口上传企业审核所需的证照信息，待中台管理员审核通过后，方可真正开户，默认开通支付账户。
- 当企业证照类型为普通企业时：营业执照号、组织机构代码、税务登记号必填 社会统一信用代码为空
- 当企业证照类型为三证合一时：统一社会信用代码与（营业执照号、组织机构代码、税务登记号）二选一必填
调用方式：后台返回（异步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 开户申请号 | apply_id | 变长20位String | 必须 | 商户下唯一 |
| 操作类型 | operate_type | 定长1位String | 必须 | A：新增 M：修改 |
| 企业证照类型 | corp_license_type | 定长1位String | 可选 | 1.普通证照 2.三证合一 |
| 企业名称 | corp_name | 变长50位String | 必须 | 企业的公司全称 |
| 营业执照注册号 | business_code | 变长30位String | 可选 | 企业的营业执照注册号 开通线下时 营业执照注册号与统一社会信用代码二选一必填 |
| 组织机构代码 | institution_code | 定长9位String | 可选 | 企业的组织机构代码证 |
| 税务登记证号 | tax_code | 变长30位String | 可选 | 企业的税务登记号 |
| 统一社会信用代码 | social_credit_code | 定长18位String | 可选 | 企业的统一社会信用代码 开通线下时 营业执照注册号与统一社会信用代码二选一必填 |
| 证照起始日期 | license_start_date | 定长8 位String | 可选 | 开通线下必填，企业的营业证照起始日期，精确到年月日 |
| 证照结束日期 | license_end_date | 定长8 位String | 可选 | 开通线下必填，企业的营业证照结束日期，精确到年月日，支持“永久” |
| 企业经营地址 | corp_business_address | 变长250位String | 可选 | 企业的经营地址 |
| 企业注册地址 | corp_reg_address | 变长250位String | 可选 | 开通线下必填，企业的注册地址 |
| 企业固定电话 | corp_fixed_telephone | 变长15位String | 可选 | 企业的固定电话 |
| 经营范围 | business_scope | 变长1000位String | 可选 | 企业的经营范围 |
| 控股股东 （实际控制人） | controlling_shareholder | 变长3000位String | 可选 | 非免审商户必填 数据格式：[{“custName”:”关羽”,”idCardType”:”10”,”idCard”:”330204199008187881，ratio”:”50”，shareholderAddr”:”上海市”}] |
| 法人姓名 | legal_name | 变长50位String | 必须 | 企业的法人姓名 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 法人证件号码 | legal_id_card | 变长20位String | 必须 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_cert_start_date | 定长8 位String | 必须 | 法人的证件起始日期，精确到年月日 |
| 法人证件起始日期 | legal_cert_end_date | 定长8 位String | 必须 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 必须 | 法人的手机号码 |
| 企业联系人姓名 | contact_name | 变长50位String | 必须 | 企业联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 必须 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 必须 | 联系人的邮箱地址 |
| 开户银行账户名 | bank_acct_name | 变长50位String | 可选 | 非免审商户必填 开户银行账号非空必填 企业开户银行账户名 |
| 开户银行 | bank_id | 变长8位String | 可选 | 非免审商户必填 具体见附件：开户银行代号 |
| 开户银行账号 | bank_acct_num | 变长32位String | 可选 | 非免审商户必填 企业开户银行账号 |
| 开户银行支行名称 | bank_branch | 变长100位String | 可选 | 企业开户银行的支行名称 |
| 开户银行省份 | bank_prov | 定长4位String | 可选 | 非免审商户必填 银行卡开户省份 |
| 开户银行地区 | bank_area | 定长4位String | 可选 | 非免审商户必填 银行卡开户地区 |
| 行业 | industry | 定长2位String | 可选 | 企业行业类别，具体见附件：行业 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 附件信息 | attach_nos | 变长210位String | 可选 | 非免审商户必填 配合文件上传接口，使用，多个附件之间用逗号隔开 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 开通模式 | open_mode | 变长1位String | 可选 | 0：开通线上 1：开通线下 2：开通线上线下，默认：0 |
| 线下主体类型 | offline_mode | 变长1位String | 可选 | 如果开通模式包含了开通线下（1或2）则必填，取值 1：商户 2：用户 3：渠道商 |
| 上级客户号 | upper_huifu_id | 定长16位String | 可选 | 租户开户必填，目前只支持开通线下角色时，传入渠道商客户号 |
| 注册省 | reg_prov_id | 变长6位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 注册地区 | reg_area_id | 变长8位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 注册区 | reg_district_id | 变长12位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营省 | prov_id | 变长6位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营地区 | area_id | 变长8位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营区 | district_id | 变长12位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 小票名称 | receipt_name | 变长20位String | 可选 | 开通线下必填 |
| 经营类型 | busi_type | 定长1位String | 可选 | 开通线下必填，1:实体 2:虚拟，默认1：实体 |
| 公司类型 | ent_type | 定长1位String | 可选 | 开通线下必填，1:政府机构 2:国营企业 3:私营企业 4:外资企业 5:个体工商户 7:事业单位 |
| 客服电话 | service_phone | 变长32位String | 可选 | 开通线下必填 |
| 所属行业（MCC） | mcc | 变长4位String | 可选 | 开通线下必填，请参照附件 《银联MCC编码.xlsx》 的“MCC码” |
| 商户经营类目 | alipay_mcc | 变长5位String | 可选 | 2015050700000000：美食；2015091000052157：超市便利店；2015062600004525：休闲娱乐；2015062600002758：购物；2016062900190124：爱车；2015063000020189：生活服务；2016042200000148：教育培训；2016062900190296：医疗健康；2015080600000001：航旅；2016062900190337：专业销售/批发；2016062900190371：政府/社会组织；注：alipay_cls_code不为空时，必传 |
| cls | alipay_cls_code | 变长32位String | 可选 | 开通线下且支付宝入驻时必填，请参照附件 《支付宝类目.xlsx》 的“支付宝双联通cls” |
| 商户经营类目 | wechat_mcc | 变长32位String | 可选 | 开通线下且微信入驻时必填，请参照附件 《微信经营类目.xlsx》 的“微信经营类目码” |
| 入驻开关 | config_switch | 变长1000位String | 可选 | JSON字符串 {"forcedDelayFlag":"Y","delayFlag":"Y","platformRefund":"Y","supportDebit":"Y","onlineRefund":"Y","preAuthorization":"Y","supportRevoke":"Y","refundToDoSurrogate":"Y"} |
| 支付宝费率相关配置 | ali_pay_config_list | 变长3000位String | 可选 | JSON字符串 [{"sustainDebit":"","switchState":"","alipayPayRate":"0.01","outFeeFlag":"1","busiType":"","outFeeAcctid;":"","outFeeHuifuid":"","feeChargeType":"1","alipayFormula":"","feeType":"2"}] |
| 微信费率相关配置 | wx_pay_config_list | 变长3000位String | 可选 | JSON字符串 [{"sustainDebit":"","switchState":"","wxPayRate":"0.01","outFeeFlag":"1","busiType":"","outFeeAcctid;":"","outFeeHuifuid":"","feeChargeType":"1","wxPayFormula":"","feeType":"2"}] |
| 银行卡支付业务配置 | bankcard_payment_conf | 变长3000位String | 可选 | JSON字符串 {"chargeCateCode":"03","switchState":"","debitFeeRate":"0.04","debitFeeLimit":"200.00","creditFeeRate":"0.08","isOpenCloudFlag":"1","cloudDebitFeeRateUp":"","cloudCreditFeeRateUp":"","cloudDebitFeeRateDown":"","cloudDebitFeeLimitDown":"","isOpenSmallFlag":"","smallFreeAmt":"","smallFeeAmt":"","outFeeFlag":"","outFeeAcctid":"","outFeeHuifuid":"","feeChargeType":"","bankPayFormula":""} |
| 银联二维码费率相关配置 | union_pay_qr_config_list | 变长3000位String | 可选 | JSON字符串 [{"chargeCateCode":"03","switchState":"","debitFeeRateUp":"0.05","debitFeeLimitUp":"0.05","creditFeeRate":"0.08","busiType;":"","creditFeeRateUp":"0.08","cloudCreditFeeRateUp":"0.08","debitFeeRateDown":"0.08","debitFeeLimitDown":"0.08","creditFeeRateDown":"0.08","outFeeFlag":"1","outFeeAcctid":"","outFeeHuifuid":"","feeChargeType":"1","unionPayFormula":"","unionPayCreditFormula":""}] |
| 协议信息 | agreement_info | 变长1000位String | 可选 | JSON字符串 {"agreementType":"1","agreementNo":"","agreementModel":"","agreementName":"","signDate":""} |
| 发送短信标识 | sms_send_flag | 定长1位String | 可选 | 使用线下pos机时必填，1：需要发送短信 |
| 管理员账号 | login_name | 变长32位String | 可选 | 开通线下时的管理员账号，必须全网唯一； |
| 交易异步应答地址 | recon_resp_addr | 变长256位String | 可选 |
股东信息
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 姓名 | custName | 变长20位String | 必须 | |
| 证件类型 | idCardType | 定长8位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 证件号码 | idCard | 变长20位String | 必须 | 股东的证件号码，与证件类型对应 |
| 股东地址 | shareholderAddr | 变长250位String | 可选 | |
| 股份占比 | ratio | 变长4位String | 可选 |
入驻开关
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| forcedDelayFlag | 商户开通强制延迟标记 | 定长1位String | 可选 | Y:开通 N:关闭 默认否 |
| delayFlag | 是否开通延迟入账 | 定长1位String | 可选 | 选项：N：否 Y：是，默认否(如果填写Y，开通延迟户) |
| platformRefund | 是否支持平台退款 | 定长1位String | 可选 | Y:开通 N:关闭（默认开通） |
| supportDebit | 是否仅支持借记卡 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
| onlineRefund | 是否开通在线退货（终端） | 定长1位String | 可选 | Y:开通 N:关闭（默认开通） |
| preAuthorization | 是否开通预授权 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
| supportRevoke | 是否支持撤销交易 | 定长1位String | 可选 | Y:开通 N:关闭(默认开通) |
| refundToDoSurrogate | 是否开通退货失败转代发 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
支付宝费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借贷记卡配置 | sustainDebit | 定长1位String | 可选 | 空或者0都支持,1:仅支持借记卡 |
| 支付宝支付手续费(%) | alipayPayRate | BigDecimal | 可选 | |
| 费率公式 | alipayFormula | String | 可选 | 优先使用 |
| 业务开通类型 | feeType | 定长2位String | 必须 | 业务开通类型：02-标准费率线下；03-非盈利费率；04-缴费费率；06-行业活动费率 |
| 交易类型 | busiType | String | 可选 | 不填：默认所有交易类型统一费率，只有线下费率可区分交易类型配置费率：支付宝JS-A_JSAPI；支付宝正扫-A_NATIVE；支付宝反扫-A_MICROPAY |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长18位String | 可选 | 交易手续费外扣时必填 |
微信费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借贷记卡配置 | sustainDebit | 定长1位String | 可选 | 空或者0都支持,1:仅支持借记卡 |
| 微信支付手续费(%) | wxPayRate | BigDecimal | 可选 | |
| 费率公式 | wxPayFormula | String | 可选 | 优先使用 |
| 业务开通类型 | feeType | 定长2位String | 必须 | 业务开通类型：01-标准费率线上；02-标准费率线下；03-非盈利费率；04-缴费费率；05-保险费率；06-行业活动费率；07-校园餐饮费率；08-中小幼费率 |
| 交易类型 | busiType | String | 可选 | 不填：默认所有交易类型统一费率，只有线下/线上费率可区分交易类型配置费率：微信公众号-T_JSAPI；微信小程序-T_MINIAPP；微信反扫-T_MICROPAY |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长18位String | 可选 | 交易手续费外扣必填 |
银联二维码费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 银行业务手续费类型 | chargeCateCode | 定长2位String | 可选 | 默认为：03-标准类；01-减免类；02-优惠类；03-标准类 |
| 交易类型 | busiType | 定长2位String | 可选 | 不填：默认所有交易类型统一费率，目前可区分交易类型：银联正扫-U_NATIVE；银联JS-U_JSAPI；银联反扫-U_MICROPAY |
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借记卡手续费1000以上（%） | debitFeeRateUp | BigDecimal | 必填 | |
| 借记卡封顶1000以上 | debitFeeLimitUp | BigDecimal | 可选 | |
| 银联二维码业务贷记卡手续费1000以上（%） | creditFeeRateUp | BigDecimal | 必填 | |
| 借记卡手续费1000以下（%） | debitFeeRateDown | BigDecimal | 必填 | |
| 借记卡封顶1000以下 | debitFeeLimitDown | BigDecimal | 可选 | |
| 银联二维码业务贷记卡手续费1000以下（%） | creditFeeRateDown | BigDecimal | 必填 | |
| 费率公式（借记卡） | unionPayFormula | String | 可选 | 优先使用 |
| 费率公式（贷记卡） | unionPayCreditFormula | String | 可选 | 优先使用(如果为空，使用unionPayFormula) |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长16位String | 可选 | 交易手续费外扣时必填 |
银行卡支付配置
| 中文名 | 参数 | 定义 | 必填 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 银行业务手续费类型 | chargeCateCode | 定长2位String | 可选 | 默认为：03-标准类；01-减免类；02-优惠类；03-标准类 |
| 借记卡手续费（%） | debitFeeRate | BigDecimal | 必填 | |
| 借记卡封顶值 | debitFeeLimit | BigDecimal | 可选 | |
| 贷记卡手续费（%） | creditFeeRate | BigDecimal | 必填 | |
| 是否开通云闪付 | isOpenCloudFlag | 定长1位String | 必填 | 目前默认开通。选项：0：否 1：是， |
| 云闪付借记卡手续费1000以上（%） | cloudDebitFeeRateUp | BigDecimal | 可选 | |
| 云闪付借记卡封顶1000以上(元) | cloudDebitFeeLimitUp | BigDecimal | 可选 | |
| 云闪付贷记卡手续费1000以上（%） | cloudCreditFeeRateUp | BigDecimal | 可选 | |
| 云闪付借记卡手续费1000以下（%） | cloudDebitFeeRateDown | BigDecimal | 可选 | |
| 云闪付借记卡封顶1000以下(元) | cloudDebitFeeLimitDown | BigDecimal | 可选 | |
| 云闪付贷记卡手续费1000以下（%） | cloudCreditFeeRateDown | BigDecimal | 可选 | |
| 费率公式（借记卡） | bankPayFormula | String | 可选 | 优先使用 |
| 费率公式（贷记卡） | bankPayCreditFormula | String | 可选 | 优先使用(如果为空，使用bankPayFormula) |
| 是否开通小额双免 | isOpenSmallFlag | 定长1位String | 可选 | 开关状态 0:不开通双免 1:开通双免 2:仅免签 |
| 小额双免单笔限额(元) | smallFreeAmt | BigDecimal | 可选 | 限额需小于等于1000，不传默认0（不开通小额双免） |
| 小额双免手续费 | smallFeeAmt | BigDecimal | 可选 | |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长16位String | 可选 | 交易手续费外扣时必填 |
协议信息
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 协议类型 | agreementType | String | 必须 | 协议类型 0-电子协议 1-纸质协议’, |
| 协议号 | agreementNo | String | 可选 | |
| 协议模板号 | agreementModel | String | 可选 | 协议类型0时必填 |
| 协议模板名称 | agreementName | String | 可选 | 协议类型0时必填 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000–调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 企业开户申请号 | apply_id | 变长20 String | 必须 | 由商户提供,申请企业开户的唯一标识 |
| 企业用户客户号 | user_cust_id | 定长16位String | 可选 | |
| 订单号 | order_id | 定长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 订单日期 | order_date | 定长8 位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 商户唯一标识号 | mer_cust_id | 变长16位String | 必须 | 由汇付生成，商户的唯一标识号 |
| 企业名称 | corp_name | 变长50位String | 必须 | 企业的公司全称 |
| 线上子账户号 | acct_id | 变长9位String | 可选 | 基本户-支付账户 |
| 线下开通账户号 | offline_acct_id | 变长9位String | 可选 | 开通线下时的线下收款账户 |
| 取现绑定银行卡ID | bind_card_id | 变长20位String | 可选 | |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 银行虚拟账户 | bank_virtual_acct_num | 变长40位String | 可选 |
返回码¶
| 返回码 | 返回描述 |
|---|---|
| 公共返回码 | |
| A40001 | 省份地区信息非法 |
| A40009 | 控股股东不能超过二十个 |
| A40010 | 控股股东部分字段为空 |
| A40011 | 控股股东部分字段长度超长 |
| A40012 | 控股股东证件类型不存在 |
| A40013 | 控股股东身份证不合法 |
| A40014 | 该企业证照类型与证照号不匹配 |
| A40015 | 该申请号已开户 |
| A40016 | 该企业营业执照注册号或者社会统一信用码已开户 |
| A40017 | 该企业开户申请正在审核中，不能修改 |
| A40018 | 该企业开户申请已被拒绝，不能修改 |
| A40019 | 该企业开户申请已经通过，不能修改 |
| A40020 | 未查询到原开户申请号 |
| A40021 | 该申请号已申请开户 |
| A40022 | 营业执照注册号或者社会统一信用码已申请开户 |
| A40023 | 附件信息不存在 |
| A40024 | 附件数量超出10个限制 |
| A40025 | 附件文件不存在 |
| A40026 | 文件已被使用 |
| A40028 | 银行信息不存在 |
| A40031 | 原企业开户申请状态为关闭，不能修改 |
| A40045 | 审核拒绝，拒绝说明 |
| A40046 | 审核待修改，修改说明 |
| A40047 | 开户成功，绑卡失败 |
| A40054 | 审核状态错误 |
| H10005 | 银行卡已存在 |
| A40102 | 用户不存在 |
| A40103 | 该用户已开户 |
| A40104 | 收款方必须开通汇付账户 |
| A40105 | 开户请求银行处理中,请勿重复提交 |
| A40106 | 请上传文件 |
corp02 企业开户申请（页面版）¶
功能说明¶
适用产品企账通/app+，用于在本平台系统下为企业用户开户。先通过页面上传企业审核所需要的证照信息，待中台管理员审核通过后，方可真正开户，默认开通支付账户。
调用方式：后台返回（同步,异步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 开户申请号 | apply_id | 变长20位String | 必须 | 商户下唯一 |
| 操作类型 | operate_type | 定长1位String | 必须 | A：新增 M：修改 |
| 企业证照类型 | corp_license_type | 定长1位String | 可选 | 1.普通证照 2.三证合一 |
| 企业名称 | corp_name | 变长50位String | 必须 | 企业的公司全称 |
| 营业执照注册号 | business_code | 变长30位String | 可选 | 企业的营业执照注册号 营业执照注册号与统一社会信用代码二选一必填 |
| 组织机构代码 | institution_code | 定长9位String | 可选 | 企业的组织机构代码证 |
| 税务登记证号 | tax_code | 变长30位String | 可选 | 企业的税务登记号 |
| 统一社会信用代码 | social_credit_code | 定长18位String | 可选 | 企业的统一社会信用代码 营业执照注册号与统一社会信用代码二选一必填 |
| 证照起始日期 | license_start_date | 定长8 位String | 可选 | 企业的营业证照起始日期，精确到年月日 |
| 证照结束日期 | license_end_date | 定长8 位String | 可选 | 企业的营业证照结束日期，精确到年月日，支持“永久” |
| 企业经营地址 | corp_business_address | 变长250位String | 可选 | 企业的经营地址 |
| 企业注册地址 | corp_reg_address | 变长250位String | 可选 | 企业的注册地址 |
| 企业固定电话 | corp_fixed_telephone | 变长15位String | 可选 | 企业的固定电话 |
| 经营范围 | business_scope | 变长1000位String | 可选 | 企业的经营范围 |
| 控股股东 （实际控制人） | controlling_shareholder | 变长3000位String | 可选 | 非免审商户必填 数据格式：[{“custName”:”关羽”,”idCardType”:”10”,”idCard”:”330204199008187881，ratio”:”50”，shareholderAddr”:”上海市”}] |
| 法人姓名 | legal_name | 变长50位String | 必须 | 企业的法人姓名 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 法人证件号码 | legal_id_card | 变长20位String | 必须 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_cert_start_date | 定长8 位String | 必须 | 法人的证件起始日期，精确到年月日 |
| 法人证件起始日期 | legal_cert_end_date | 定长8 位String | 必须 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 必须 | 法人的手机号码 |
| 企业联系人姓名 | contact_name | 变长50位String | 必须 | 企业联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 必须 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 必须 | 联系人的邮箱地址 |
| 开户银行账户名 | bank_acct_name | 变长50位String | 必须 | 企业开户银行账户名 |
| 开户银行 | bank_id | 变长8位String | 可选 | 非免审商户必填 开户银行账号非空必填 具体见附件：开户银行代号 |
| 开户银行账号 | bank_acct_num | 变长32位String | 可选 | 非免审商户必填 企业开户银行账号 |
| 开户银行支行名称 | bank_branch | 变长100位String | 可选 | 企业开户银行的支行名称 |
| 开户银行省份 | bank_prov | 定长4位String | 可选 | 非免审商户必填 开户银行账号非空必填 银行卡开户省份 |
| 开户银行地区 | bank_area | 定长4位String | 可选 | 非免审商户必填 开户银行账号非空必填 银行卡开户地区 |
| 行业 | industry | 定长2位String | 可选 | 企业行业类别，具体见附件：行业 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上，也面版可选参数 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 |
股东信息
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 姓名 | custName | 变长20位String | 必须 | |
| 证件类型 | idCardType | 定长8位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 证件号码 | idCard | 变长20位String | 必须 | 股东的证件号码，与证件类型对应 |
| 股东地址 | shareholderAddr | 变长250位String | 可选 | |
| 股份占比 | ratio | 变长4位String | 可选 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | 见返回码附件表 |
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 企业开户申请号 | apply_id | 变长50 String | 必须 | 由商户提供,申请企业开户的唯一标识 |
| 企业用户客户号 | user_cust_id | 定长16位String | 可选 | |
| 订单号 | order_id | 定长20位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 |
| 订单日期 | order_date | 定长8 位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 商户唯一标识号 | mer_cust_id | 变长16位String | 必须 | 由汇付生成，商户的唯一标识号 |
| 企业名称 | corp_name | 变长50位String | 必须 | 企业的公司全称 |
| 子账户号 | acct_id | 变长9位String | 可选 | 基本户-支付账户 |
| 取现绑定银行卡ID | bind_card_id | 变长20位String | 可选 | |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 银行虚拟账户 | bank_virtual_acct_num | 变长40位String | 可选 |
返回码¶
| 返回码 | 返回描述 |
|---|---|
| 公共返回码 | |
| A40001 | 省份地区信息非法 |
| A40009 | 控股股东不能超过二十个 |
| A40010 | 控股股东部分字段为空 |
| A40011 | 控股股东部分字段长度超长 |
| A40012 | 控股股东证件类型不存在 |
| A40013 | 控股股东身份证不合法 |
| A40014 | 该企业证照类型与证照号不匹配 |
| A40015 | 该申请号已开户 |
| A40016 | 该企业营业执照注册号或者社会统一信用码已开户 |
| A40017 | 该企业开户申请正在审核中，不能修改 |
| A40018 | 该企业开户申请已被拒绝，不能修改 |
| A40019 | 该企业开户申请已经通过，不能修改 |
| A40020 | 未查询到原开户申请号 |
| A40021 | 该申请号已申请开户 |
| A40022 | 营业执照注册号或者社会统一信用码已申请开户 |
| A40023 | 附件信息不存在 |
| A40024 | 附件数量超出10个限制 |
| A40025 | 附件文件不存在 |
| A40026 | 文件已被使用 |
| A40028 | 银行信息不存在 |
| A40031 | 原企业开户申请状态为关闭，不能修改 |
| A40045 | 审核拒绝，拒绝说明 |
| A40046 | 审核待修改，修改说明 |
| A40047 | 开户成功，绑卡失败 |
| A40102 | 用户不存在 |
| A40103 | 该用户已开户 |
| A40104 | 收款方必须开通汇付账户 |
| A40105 | 开户请求银行处理中,请勿重复提交 |
| A40106 | 请上传文件 |
solo01 个体户开户申请（后台版）¶
功能说明¶
适用产品企账通/app+，用于在本平台系统下为企业用户开户。该接口需要配合文件上传接口使用，先调用文件上传接口上传个体户审核所需的证照信息，待中台管理员审核通过后，方可真正开户，默认开通支付账户。
调用方式：后台返回（同步，异步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 开户申请号 | apply_id | 变长20位String | 必须 | 商户下唯一 |
| 操作类型 | operate_type | 定长1位String | 必须 | A：新增 M：修改 |
| 个体户名称 | solo_name | 变长50位String | 必须 | 个体户名称 |
| 营业执照注册号 | business_code | 变长30位String | 必须 | 企业的营业执照注册号 |
| 证照起始日期 | license_start_date | 定长8 位String | 必须 | 企业的营业证照起始日期，精确到年月日 |
| 证照结束日期 | license_end_date | 定长8 位String | 必须 | 企业的营业证照结束日期，精确到年月日，支持“永久” |
| 个体户经营地址 | solo_business_address | 变长250位String | 必须 | 个体户的经营地址 |
| 个体户注册地址 | solo_reg_address | 变长250位String | 必须 | 个体户的注册地址 |
| 个体户固定电话 | solo_fixed_telephone | 变长15位String | 必须 | 企业的固定电话 |
| 经营范围 | business_scope | 变长1000位String | 必须 | 企业的经营范围 |
| 法人姓名 | legal_name | 变长50位String | 必须 | 企业的法人姓名 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 22：其他 |
| 法人证件号码 | legal_id_card | 变长20位String | 必须 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_cert_start_date | 定长8 位String | 必须 | 法人的证件起始日期，精确到年月日 |
| 法人证件起始日期 | legal_cert_end_date | 定长8 位String | 必须 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 必须 | 法人的手机号码 |
| 企业联系人姓名 | contact_name | 变长50位String | 必须 | 企业联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 必须 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 必须 | 联系人的邮箱地址 |
| 职业 | occupation | 定长2位String | 必须 | 01：国家机关、党群机关、企事业单位负责人 02：金融业从业人员 03：房地产业从业人员 04：商贸从业人员 05：自由职业者 06：科教文从业人员 07：制造业从业人员 08：卫生行业从业人员, 09：IT业从业人员 10：农林牧渔劳动者 11：生产工作、运输工作和部分体力劳动者 12：退休人员 13：不便分类的其他劳动者 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 附件信息 | attach_nos | 变长210位String | 必须 | 配合文件上传接口，使用，多个附件之间用逗号隔开”a,b” |
| 银行卡号 | bank_acct_num | 变长String | 可选 | 变长9-32位银行卡号 |
| 省份 | bank_prov | 定长4位String | 可选 | |
| 地区 | bank_area | 定长4位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 开通模式 | open_mode | 变长1位String | 可选 | 0：开通线上 1：开通线下 2：开通线上线下，默认：0 |
| 线下主体类型 | offline_mode | 变长1位String | 可选 | 如果开通模式包含了开通线下（1或2）则必填，取值 1：商户 2：用户 3：渠道商 |
| 上级客户号 | upper_huifu_id | 定长16位String | 可选 | 租户开户必填，目前只支持开通线下角色时，传入渠道商客户号 |
| 注册省 | reg_prov_id | 变长6位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 注册地区 | reg_area_id | 变长8位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 注册区 | reg_district_id | 变长12位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营省 | prov_id | 变长6位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营地区 | area_id | 变长8位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 经营区 | district_id | 变长12位String | 可选 | 开通线下必填，请参照附件 《商户入驻省市区编码.xlsx》 |
| 小票名称 | receipt_name | 变长20位String | 可选 | 开通线下必填 |
| 经营类型 | busi_type | 变长1位String | 可选 | 开通线下必填，1:实体 2:虚拟，默认，1：实体 |
| 公司类型 | ent_type | 可选 | 开通线下必填，1:政府机构 2:国营企业 3:私营企业 4:外资企业 5:个体工商户 7:事业单位 | |
| 客服电话 | service_phone | 变长32位String | 可选 | 开通线下必填 |
| 所属行业（MCC） | mcc | 变长4位String | 可选 | 开通线下必填 |
| 商户经营类目 | alipay_mcc | 变长5位String | 可选 | 2015050700000000：美食；2015091000052157：超市便利店；2015062600004525：休闲娱乐；2015062600002758：购物；2016062900190124：爱车；2015063000020189：生活服务；2016042200000148：教育培训；2016062900190296：医疗健康；2015080600000001：航旅；2016062900190337：专业销售/批发；2016062900190371：政府/社会组织；注：alipay_cls_code不为空时，必传 |
| cls | alipay_cls_code | 变长32位String | 可选 | 开通线下且支付宝入驻时必填，请参照附件 《支付宝类目.xlsx》 的“支付宝双联通cls” |
| 商户经营类目 | wechat_mcc | 变长32位String | 可选 | 开通线下且微信入驻时必填，请参照附件 《微信经营类目.xlsx》 的“微信经营类目码” |
| 入驻开关 | config_switch | 变长1000位String | 可选 | JSON字符串 {"forcedDelayFlag":"Y","delayFlag":"Y","platformRefund":"Y","supportDebit":"Y","onlineRefund":"Y","preAuthorization":"Y","supportRevoke":"Y","refundToDoSurrogate":"Y"} |
| 支付宝费率相关配置 | ali_pay_config_list | 变长3000位String | 可选 | JSON字符串 [{"sustainDebit":"","switchState":"","alipayPayRate":"0.01","outFeeFlag":"1","busiType":"","outFeeAcctid;":"","outFeeHuifuid":"","feeChargeType":"1","alipayFormula":"","feeType":"2"}] |
| 微信费率相关配置 | wx_pay_config_list | 变长3000位String | 可选 | JSON字符串 [{"sustainDebit":"","switchState":"","wxPayRate":"0.01","outFeeFlag":"1","busiType":"","outFeeAcctid;":"","outFeeHuifuid":"","feeChargeType":"1","wxPayFormula":"","feeType":"2"}] |
| 银行卡支付业务配置 | bankcard_payment_conf | 变长3000位String | 可选 | JSON字符串 {"chargeCateCode":"03","switchState":"","debitFeeRate":"0.04","debitFeeLimit":"200.00","creditFeeRate":"0.08","isOpenCloudFlag":"1","cloudDebitFeeRateUp":"","cloudCreditFeeRateUp":"","cloudDebitFeeRateDown":"","cloudDebitFeeLimitDown":"","isOpenSmallFlag":"","smallFreeAmt":"","smallFeeAmt":"","outFeeFlag":"","outFeeAcctid":"","outFeeHuifuid":"","feeChargeType":"","bankPayFormula":""} |
| 银联二维码费率相关配置 | union_pay_qr_config_list | 变长3000位String | 可选 | JSON字符串 [{"chargeCateCode":"03","switchState":"","debitFeeRateUp":"0.05","debitFeeLimitUp":"0.05","creditFeeRate":"0.08","busiType;":"","creditFeeRateUp":"0.08","cloudCreditFeeRateUp":"0.08","debitFeeRateDown":"0.08","debitFeeLimitDown":"0.08","creditFeeRateDown":"0.08","outFeeFlag":"1","outFeeAcctid":"","outFeeHuifuid":"","feeChargeType":"1","unionPayFormula":"","unionPayCreditFormula":""}] |
| 协议信息 | agreement_info | 变长1000位String | 可选 | JSON字符串 {"agreementType":"1","agreementNo":"","agreementModel":"","agreementName":"","signDate":""} |
| 发送短信标识 | sms_send_flag | 定长1位String | 可选 | 使用线下pos机时必填，1：需要发送短信 |
| 管理员账号 | login_name | 变长32位String | 可选 | 开通线下时的管理员账号，必须全网唯一；若开通线下且未填，则自动生成，规则：用户ID后9位+随机3个英文字母（区分大小写） |
| 交易异步应答地址 | recon_resp_addr | 变长256位String | 可选 |
入驻开关
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| forcedDelayFlag | 商户开通强制延迟标记 | 定长1位String | 可选 | Y:开通 N:关闭 默认否 |
| delayFlag | 是否开通延迟入账 | 定长1位String | 可选 | 选项：N：否 Y：是，默认否(如果填写Y，开通延迟户) |
| platformRefund | 是否支持平台退款 | 定长1位String | 可选 | Y:开通 N:关闭（默认开通） |
| supportDebit | 是否仅支持借记卡 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
| onlineRefund | 是否开通在线退货（终端） | 定长1位String | 可选 | Y:开通 N:关闭（默认开通） |
| preAuthorization | 是否开通预授权 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
| supportRevoke | 是否支持撤销交易 | 定长1位String | 可选 | Y:开通 N:关闭(默认开通) |
| refundToDoSurrogate | 是否开通退货失败转代发 | 定长1位String | 可选 | Y:开通 N:关闭 默认关闭 |
支付宝费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借贷记卡配置 | sustainDebit | 定长1位String | 可选 | 空或者0都支持,1:仅支持借记卡 |
| 支付宝支付手续费(%) | alipayPayRate | BigDecimal | 可选 | |
| 费率公式 | alipayFormula | String | 可选 | 优先使用 |
| 业务开通类型 | feeType | 定长2位String | 必须 | 业务开通类型 02-标准费率线下；03-非盈利费率；04-缴费费率；06-行业活动费率 |
| 交易类型 | busiType | String | 可选 | 不填：默认所有交易类型统一费率，只有线下费率可区分交易类型配置费率：支付宝JS-A_JSAPI；支付宝正扫-A_NATIVE；支付宝反扫-A_MICROPAY |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长18位String | 可选 | 交易手续费外扣时必填 |
微信费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借贷记卡配置 | sustainDebit | 定长1位String | 可选 | 空或者0都支持,1:仅支持借记卡 |
| 微信支付手续费(%) | wxPayRate | BigDecimal | 可选 | |
| 费率公式 | wxPayFormula | String | 可选 | 优先使用 |
| 业务开通类型 | feeType | 定长2位String | 必须 | 业务开通类型 01-标准费率线上；02-标准费率线下；03-非盈利费率；04-缴费费率；05-保险费率；06-行业活动费；07-校园餐饮费率；08-中小幼费率 |
| 交易类型 | busiType | String | 可选 | 不填：默认所有交易类型统一费率，只有线下/线上费率可区分交易类型配置费率。微信公众号-T_JSAPI；微信小程序-T_MINIAPP；微信反扫-T_MICROPAY |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长18位String | 可选 | 交易手续费外扣必填 |
银联二维码费率相关配置
| 中文名 | 参数 | 定义 | 非空 | 说明 |
|---|---|---|---|---|
| 银行业务手续费类型 | chargeCateCode | 定长2位String | 可选 | 默认为03-标准类 ；01-减免类；02-优惠类；03-标准类 |
| 交易类型 | busiType | 定长2位String | 可选 | 不填：默认所有交易类型统一费率，目前可区分交易类型：银联正扫-U_NATIVE；银联JS-U_JSAPI；银联反扫-U_MICROPAY |
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 借记卡手续费1000以上（%） | debitFeeRateUp | BigDecimal | 必填 | |
| 借记卡封顶1000以上 | debitFeeLimitUp | BigDecimal | 可选 | |
| 银联二维码业务贷记卡手续费1000以上（%） | creditFeeRateUp | BigDecimal | 必填 | |
| 借记卡手续费1000以下（%） | debitFeeRateDown | BigDecimal | 必填 | |
| 借记卡封顶1000以下 | debitFeeLimitDown | BigDecimal | 可选 | |
| 银联二维码业务贷记卡手续费1000以下（%） | creditFeeRateDown | BigDecimal | 必填 | |
| 费率公式（借记卡） | unionPayFormula | String | 可选 | 优先使用 |
| 费率公式（贷记卡） | unionPayCreditFormula | String | 可选 | 优先使用(如果为空，使用unionPayFormula) |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长16位String | 可选 | 交易手续费外扣时必填 |
银行卡支付配置
| 中文名 | 参数 | 定义 | 必填 | 说明 |
|---|---|---|---|---|
| 开通状态 | switchState | 定长1位String | 可选 | 0:关闭 1:开通 默认开通 |
| 银行业务手续费类型 | chargeCateCode | 定长2位String | 可选 | 默认为：03-标准类 ；01-减免类；02-优惠；03-标准类 |
| 借记卡手续费（%） | debitFeeRate | BigDecimal | 必填 | |
| 借记卡封顶值 | debitFeeLimit | BigDecimal | 可选 | |
| 贷记卡手续费（%） | creditFeeRate | BigDecimal | 必填 | |
| 是否开通云闪付 | isOpenCloudFlag | 定长1位String | 必填 | 目前默认开通。选项：0：否 1：是， |
| 云闪付借记卡手续费1000以上（%） | cloudDebitFeeRateUp | BigDecimal | 可选 | |
| 云闪付借记卡封顶1000以上(元) | cloudDebitFeeLimitUp | BigDecimal | 可选 | |
| 云闪付贷记卡手续费1000以上（%） | cloudCreditFeeRateUp | BigDecimal | 可选 | |
| 云闪付借记卡手续费1000以下（%） | cloudDebitFeeRateDown | BigDecimal | 可选 | |
| 云闪付借记卡封顶1000以下(元) | cloudDebitFeeLimitDown | BigDecimal | 可选 | |
| 云闪付贷记卡手续费1000以下（%） | cloudCreditFeeRateDown | BigDecimal | 可选 | |
| 费率公式（借记卡） | bankPayFormula | String | 可选 | 优先使用 |
| 费率公式（贷记卡） | bankPayCreditFormula | String | 可选 | 优先使用(如果为空，使用bankPayFormula) |
| 是否开通小额双免 | isOpenSmallFlag | 定长1位String | 可选 | 开关状态 0:不开通双免 1:开通双免 2:仅免签 |
| 小额双免单笔限额(元) | smallFreeAmt | BigDecimal | 可选 | 限额需小于等于1000，不传默认0（不开通小额双免） |
| 小额双免手续费 | smallFeeAmt | BigDecimal | 可选 | |
| 交易手续费外扣标记 | outFeeFlag | 定长1位String | 可选 | 1:外扣 2:内扣（默认2内扣） |
| 交易手续费收取类型 | feeChargeType | 定长1位String | 可选 | 1:实收 2:后收(默认实收) |
| 交易手续费外扣汇付ID | outFeeHuifuid | 变长18位String | 可选 | 交易手续费外扣时必填 |
| 交易手续费外扣SPIN子账户号 | outFeeAcctid | 变长16位String | 可选 | 交易手续费外扣时必填 |
协议信息
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 协议类型 | agreementType | String | 必须 | 协议类型 0-电子协议 1-纸质协议’, |
| 协议号 | agreementNo | String | 可选 | |
| 协议模板号 | agreementModel | String | 可选 | 协议类型0时必填 |
| 协议模板名称 | agreementName | String | 可选 | 协议类型0时必填 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 开户申请号 | apply_id | 变长20 位String | 必须 | 由商户提供,申请企业开户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | |
| 订单号 | order_id | 定长50位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 |
| 订单日期 | order_date | 定长8 位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 商户唯一标识号 | mer_cust_id | 变长16位String | 必须 | 由汇付生成，商户的唯一标识号 |
| 个体户名称 | solo_name | 变长50位String | 必须 | 企业的公司全称 |
| 线上子账户号 | acct_id | 变长9位String | 可选 | 基本户-支付账户 |
| 线下开通账户号 | offline_acct_id | 变长9位String | 可选 | 开通线下时的线下收款账户 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 银行虚拟账户 | bank_virtual_acct_num | 变长40位String | 可选 |
返回码¶
| 返回码 | 返回描述 |
|---|---|
| 公共返回码 | |
| A40024 | 附件数量超出10个限制 |
| A40025 | 附件文件不存在 |
| A40026 | 文件已被使用 |
| A40032 | 该个体工商户开户申请审核已通过，不能修改 |
| A40033 | 该个体工商户开户申请正在审核中，不能修改 |
| A40034 | 该个体工商户开户申请审核拒绝，不能修改 |
| A40036 | 原个体户开户请求不存在 |
| A40037 | 该申请号已开户 |
| A40038 | 个体户开户申请号已申请开户 |
| A40039 | 营业执照注册号已被使用 |
| A40045 | 审核拒绝，拒绝说明 |
| A40046 | 审核待修改，修改说明 |
| A40047 | 开户成功，绑卡失败 |
| A40054 | 审核状态错误 |
| H10005 | 银行卡已存在 |
| A40102 | 用户不存在 |
| A40103 | 该用户已开户 |
| A40104 | 收款方必须开通汇付账户 |
| A40105 | 开户请求银行处理中,请勿重复提交 |
| A40106 | 请上传文件 |
user03 用户状态更新¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 用户状态 | stat_flag | 变长1位String | 必须 | 1:开 0:关 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | 见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 用户状态 | stat_flag | 变长1位String | 必须 | 1:开 0:关 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
user07 用户信息变更¶
功能说明¶
用于在本平台系统下变更企业/个体工商户基本信息及证照信息。该接口需要配合文件上传接口（最多上传，1：营业执照注册号，4：法人证件正面，5：开户银行许可证（只有企业才有），10：法人证件反面，11：经营照片，13：经营照片（门头照片））使用，先调用文件上传接口上传企业/个体工商户审核所需的证照信息。
调用方式：后台返回（同步，异步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20220407 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 用户全称 | user_name | 变长50位String | 可选 | 营业执照名称 |
| 用户经营地址 | business_address | 变长250位String | 可选 | 用户经营地址 |
| 用户注册地址 | reg_address | 变长250位String | 可选 | 填写用户营业执照经营地址 |
| 营业执照起始日期 | license_start_date | 定长8 位String | 可选 | 营业执照起始日期，精确到年月日 |
| 营业执照起始日期 | license_end_date | 定长8 位String | 可选 | 营业执照结束日期，精确到年月日，支持“永久” |
| 经营范围 | business_scope | 变长1000位String | 可选 | 填写营业执照中经营范围 |
| 法人姓名 | legal_name | 变长50位String | 可选 | 法人姓名、法人证件类型和法人证件号码三者不能单独传值 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 可选 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 法人证件号码 | legal_id_card | 变长18位String | 可选 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_cert_start_date | 定长8 位String | 可选 | 法人的证件起始日期，精确到年月日 |
| 法人证件起始日期 | legal_cert_end_date | 定长8 位String | 可选 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 可选 | 法人的手机号码 |
| 联系人姓名 | contact_name | 变长50位String | 可选 | 联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 可选 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 可选 | 联系人的邮箱地址 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 必须 | 通过后台异步通知商户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 附件信息 | attach_nos | 变长1024位String | 可选 | 配合文件上传接口，使用，多个附件之间用逗号隔开 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000–调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20220407 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 用户全称 | user_name | 变长50位String | 可选 | 营业执照名称 |
| 用户经营地址 | business_address | 变长250位String | 可选 | 用户经营地址 |
| 用户注册地址 | reg_address | 变长250位String | 可选 | 填写用户营业执照经营地址 |
| 经营范围 | business_scope | 变长1000位String | 可选 | 填写营业执照中经营范围 |
| 法人姓名 | legal_name | 变长50位String | 可选 | 法人姓名 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 可选 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 法人证件号码 | legal_id_card | 变长18位String | 可选 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_cert_start_date | 定长8 位String | 可选 | 法人的证件起始日期，精确到年月日 |
| 法人证件起始日期 | legal_cert_end_date | 定长8 位String | 可选 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 可选 | 法人的手机号码 |
| 联系人姓名 | contact_name | 变长50位String | 可选 | 联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 可选 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 可选 | 联系人的邮箱地址 |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 必须 | 通过后台异步通知商户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 附件信息 | attach_nos | 变长1024位String | 可选 | 配合文件上传接口，使用，多个附件之间用逗号隔开 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 |
acct02 新增子账户（页面版）¶
功能说明¶
适用产品企账通，给用户添加子账户，请求后会跳转协议页面，用户同意后，开通子账户。注：用户开户时，会自动开一个子账户，每个用户子账户数量不能超过5个。
调用方式：页面返回（同步）
调用地址:
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本 | version | 固定2位String | 必须 | 固定为10，如版本升级，能向前兼容 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 保证订单号和订单日期唯一，格式为 YYYYMMDD |
| 订单号 | order_id | 变长50位String | 必须 | 保证订单号和订单日期唯一 |
| 账户类型 | acct_type | 定长2位String | 可选 | 15：基本支付账户 16：基本非支付账户 不填默认16; |
| 账户名称 | acct_name | 变长20位String | 可选 | |
| 页面返回URL | ret_url | 变长128位String | 可选 | 本平台把交易结果通过页面方式返回商户 |
| 终端类型 | request_type | 定长1位 | 可选 | P：PC端 M：移动端 默认为PC |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 设备静态信息 | dev_info | 变长512位String | 可选 | 参见 设备静态信息 。 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | 其他见返回码表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 账户号 | acct_id | 变长9位String | 可选 | |
| 账户等级 | acct_level | 变长9位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 设备静态信息 | dev_info | 变长512位String | 可选 | 参见 设备静态信息 。 |
acct01 新增子账户（后台版)¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 保证订单号和订单日期唯一，格式为 YYYYMMDD |
| 订单号 | order_id | 变长50位String | 必须 | 保证订单号和订单日期唯一 |
| 账户类型 | acct_type | 定长3位String | 可选 | 15：基本支付账户 16：基本非支付账户 18:线下收款账户 不填默认16; |
| 账户名称 | acct_name | 变长20位String | 可选 | |
| 是否同意支付协议 | is_agree_pay_protocol | 定长1位String | 可选 | 1：同意 2：不同意 注：账户类型为支付账户时需同意支付协议 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 本平台把交易结果通过页面方式返回商户 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 设备静态信息 | dev_info | 变长512位String | 可选 | 参见 设备静态信息 。 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | 其他见返回码表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 账户号 | acct_id | 变长9位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 设备静态信息 | dev_info | 变长512位String | 可选 | 参见 设备静态信息 。 |
file01 文件上传接口¶
功能说明¶
适用产品企账通/app+，接口功能说明： 上传企业开户，个体户开户的资料文件。
- 目前支持的文件格式：rar,zip,png,jpg,jpeg,gif,bmp,pdf,doc,docx,csv
- 当业务类型为企业开户时，企业经营信息（营业执照、组织机构代码证、税务登记证）与统一社会代码证二选一必传，法人证件、法人证件反面、开户银行许可证必传
- 当业务类型为个体户开户时，营业执照、法人证件、结算卡正面、结算卡反面必传
- 附件名称不要超过25个字符
- 附件大小不要超过5M
- 上传图片必须清晰，证件字体能清楚辨认，每张证件必须盖有注册企业的 有色公章 且证件均需在有效期内
- 当业务类型为企业开户时，若企业没有开户银行许可证，可提供印鉴卡、银行流水单号、银行开户回执单，其中任一即可，必须显示对应银行的支行信息，并附有银行公章
- 当业务类型为个体户开户时，若个体工商户无公章，可上传 经营者有色指印+签名 的复印件。
调用方式：后台返回（同步）
调用地址:
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为 10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 附件编号 | attach_no | 变长20位String | 必须 | 商户下唯一 |
| 业务类型 | trans_type | 定长2位String | 必须 | 1：代理商开户 2：生利宝开户 3：企业开户 4：个体户开户 5：线下充值批量代发 |
| 附件类型 | attach_type | 定长2位String | 必须 | 1：营业执照注册号 2：组织结构代码证 3：税务登记证 4：法人证件正面 5：开户银行许可证 6：统一社会信用代码 7：快捷协议 8：代扣协议 9：开户电子协议 10：法人证件反面 11：经营照片 12：经营照片（地址照片） 13：经营照片（门头照片） 14：结算卡正面 15：结算卡反面 16：经办人证件 99：其他 |
| 文件描述 | attach_desc | 变长80位String | 可选 | |
| 文件 | attach_file | File | 必须 | 传入的中文文件名称为 UTF-8 字符集 URLEncode 编码后的字符串 |
| 上传类型 | handle_type | 定长2位String | 可选 | 1：新增 2：更新 默认为新增 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000上传成功 |
| 应答描述 | resp_desc | 变长String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 |
pwd004 设置/重置支付密码¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 操作类型 | operate_type | 变长2位String | 必须 | 01：新增 03：重置 |
| 页面类型 | request_type | 变长2位String | 可选 | P：PC端页面 M：移动端页面 默认P |
| 页面返回URL | ret_url | 变长128位的String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户私有域 | mer_priv | 变长128位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长128位的String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 结果描述 | resp_desc | 定长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 |
| 商户私有域 | mer_priv | 变长128位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长128位的String | 可选 | 用于扩展请求参数 |
pwd008 修改支付密码¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位的String | 必须 | 固定为10，如版本升级，能向前兼容 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 商户客户号 | mer_cust_id | 定长16位的String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 由汇付生成，用户的唯一性标识 个人用户必须 |
| 页面类型 | request_type | 定长1位String | 可选 | P：PC端页面M：移动端页面 不填默认PC端页面 |
| 页面返回URL | ret_url | 变长128位的String | 可选 | 交易完成后，本平台系统把交易结果通过页面方式，发送到该地址上 |
| 商户私有域 | mer_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
| 返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 结果描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 由汇付生成，用户的唯一性标识 个人用户必须 |
| 商户私有域 | mer_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
sms001 短信发送接口¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 用户客户号和手机号二选一必填（如果用户客户号和手机号同时填写，以用户注册时的手机号为准） |
| 用户手机号 | user_mobile | 定长11位String | 可选 | 用户客户号和手机号二选一必填 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 业务类型 | business_type | 定长6位的String | 可选 | 和短信内容二选一必填（如果短信内容和业务类型同时填写，以业务类型定义的模板为准）对应接口标识，如免密授权接口：传pwd001 |
| 短信内容 | sms_content | 变长256位String | 可选 | 和短信业务类型二选一必填 字符串必须包含‘’sms_code‘’字符串 例如：您的注册验证码是sms_code，五分钟内有效，请勿泄露给他人 |
| 商户私有域 | mer_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | 调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 变长16位的String | 必须 | |
| 用户客户号 | user_cust_id | 定长16位String | 可选 | 付款人汇付客户号 |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 订单号 | order_id | 变长20位String | 必须 | |
| 商户私有域 | mer_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 |
pwd001 免密授权接口（后台版）¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合(同短信订单号) |
| 开通提现免密 | cash_free_pwd_flag | 定长1位String | 可选 | 至少有一个必填 ，开通：1 |
| 开通余额支付免密 | pay_free_pwd_flag | 定长1位String | 可选 | 至少有一个必填 ，开通：1 |
| 单笔免密最高金额 | single_free_pwd_amt | 变长14位String | 可选 | 余额支付免密开启选填 |
| 是否同意协议 | agree_flag | 定长1位String | 必须 | 同意：1 |
| 验证码 | sms_code | 变长8位String | 必须 | 6位数字 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位的String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
pwd007 免密授权接口（页面版）¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 页面返回URL | ret_url | 变长128位String | 可选 | 本平台把交易结果通过页面方式返回商户 |
| 终端类型 | request_type | 定长1位 | 可选 | P：PC端 M：移动端 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
| 应答返回码 | resp_code | 定长6位String | 必须 | –调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
pwd003 免密授权取消接口¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位的String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 关闭提现免密 | cash_free_pwd_flag | 定长1位String | 可选 | 至少有一个必填，关闭0 |
| 关闭余额支付免密 | pay_free_pwd_flag | 定长1位String | 可选 | 至少有一个必填，关闭0 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
| 应答返回码 | resp_code | 定长6位String | 必须 | –调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 用户的唯一标识; |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
mer001 代理商商户开户¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 代理商商户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 商户名称 | sub_mer_name | 变长50位String | 必须 | 商户全称 |
| 商户简称 | sub_mer_short_name | 变长25位String | 必须 | 商户简称 |
| 商户英文简称 | sub_mer_en_name | 变长25位String | 必须 | 商户英文简称 |
| 注册资本 | reg_fund | 变长14位String | 必须 | 注册资本 #.## |
| 实缴资本 | paid_in_fund | 变长14位String | 必须 | 实缴资本 #.## |
| 成立时间 | est_date | 变成8位String | 必须 | 成立时间 |
| 网站地址 | sub_mer_website | 变长200位String | 必须 | 网站地址 |
| ICP备案号 | per_icp_code | 变长50位String | 必须 | ICP设备编号 |
| 网络商户登记ip | net_reg_ip | 变长40位String | 必须 | 网络商户登记ip |
| 银联商户号 | union_bank_mer_id | 变长32位String | 可选 | 银联商户号 |
| 银联银行商户类型mcc码 | cup_mcc_code | 变长10位String | 可选 | 银联银行商户类型mcc码 |
| 商户所在省份 | sub_mer_prov | 定长4位String | 必须 | 商户所在省份 |
| 商户所在地区 | sub_mer_area | 定长4位String | 必须 | 商户所在省份 |
| 商户经营地址 | sub_mer_addr | 变长250位String | 必须 | 商户经营地址 |
| 商户注册地址 | sub_mer_reg_addr | 变长250位String | 必须 | 商户注册地址 |
| 商户固定电话 | sub_mer_phone | 变长16位String | 必须 | 企业固定电话 |
| 商户服务电话 | sub_mer_service_phone | 变长16位String | 可选 | 商户服务电话 |
| 证照类型 | license_type | 定长1位String | 必须 | 证照类型 1：普通企业 2：三证合一企业 |
| 营业执照注册号 | business_code | 变长30位String | 可选 | 营业执照注册号 证照类型为1时必填 |
| 组织机构代码 | institution_code | 定长9位String | 可选 | 组织机构代码证号码 证照类型为1时必填 |
| 税务登记证号 | tax_code | 变长30位String | 可选 | 税务登记号 证照类型为1时必填 |
| 统一社会信用代码 | social_credit_code | 定长18位String | 可选 | 统一社会信用代码 证照类型为2时必填 |
| 证照起始日期 | license_begin_date | 定长8 位String | 必须 | 营业证照起始日期，精确到年月日 |
| 证照结束日期 | license_end_date | 定长8 位String | 必须 | 营业证照结束日期，精确到年月日，支持“永久” |
| 经营范围 | business_scope | 变长1000位String | 必须 | 企业的经营范围 |
| 控股股东 （实际控制人） | stockholders | 变长3000位String | 必须 | 数据格式：[{“custName”:”关羽”,”idCardType”:”10”,”idCard”:”330204199008187881，ratio”:”50”，shareholderAddr”:”上海市”}] |
| 法人姓名 | legal_name | 变长50位String | 必须 | 企业的法人姓名 |
| 法人证件类型 | legal_id_card_type | 定长2位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 法人证件号码 | legal_id_card | 变长20位String | 必须 | 法人的证件号码，与证件类型对应 |
| 法人证件起始日期 | legal_id_start_date | 定长8 位String | 必须 | 法人的证件起始日期，精确到年月日 |
| 法人证件结束日期 | legal_id_end_date | 定长8 位String | 必须 | 法人的证件结束日期，精确到年月日，支持“永久” |
| 法人手机号码 | legal_mobile | 定长11位String | 必须 | 法人的手机号码 |
| 企业联系人姓名 | contact_name | 变长50位String | 必须 | 企业联系人的姓名 |
| 联系人手机号 | contact_mobile | 定长11为String | 必须 | 联系人的手机号码 |
| 联系人邮箱 | contact_email | 变长40位String | 必须 | 联系人的邮箱地址 |
| 开户银行 | bank_id | 变长8位String | 可选 | 具体见附件：开户银行代号 |
| 开户银行账号 | bank_acct_num | 变长32位String | 可选 | 开户银行账号 |
| 开户银行支行名称 | bank_branch | 变长100位String | 可选 | 开户银行的支行名称 |
| 开户银行省份 | bank_prov | 定长4位String | 可选 | 银行卡开户省份 |
| 开户银行地区 | bank_area | 定长4位String | 可选 | 银行卡开户地区 |
| 手续费配置 | fee_conf_info | 变长1000位String | 必须 | 格式见下表 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 |
股东信息
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 姓名 | custName | 变长20位String | 必须 | |
| 证件类型 | idCardType | 定长8位String | 必须 | 10：身份证 11：护照 12：军官证 13：士兵证 14：回乡证 15：户口本 16：警官证 17：台胞证 18：组织机构代码 19：营业执照 20：税务登记证 21：统一社会信用代码证 22：其他 |
| 证件号码 | idCard | 变长20位String | 必须 | 股东的证件号码，与证件类型对应 |
| 股东地址 | shareholderAddr | 变长250位String | 可选 | |
| 股份占比 | ratio | 变长4位String | 可选 | |
| 持股金额 | holderAmt | 变长14位String | 可选 | #.## |
| 股东证件开始日期 | idCardBeginDate | 定长8位String | 可选 | 股东证件开始日期 |
| 股东证件结束日期 | idCardEndDate | 定长8位String | 可选 | 股东证件结束日期 |
手续费配置
| 参数中文名称 | 参数名称 | 是否必须 | 说明 |
|---|---|---|---|
| 手续费类型 | feeType | 必须 | 取现:01，微信正扫:02 支付宝正扫:03，银联正扫:04，微信反扫:05，支付宝反扫:06，银联反扫:07，微信app支付:08，支付宝app支付:09，支付宝统一下单:10，微信公众号支付:11，apple pay:12，微信H5支付:13，支付宝H5支付:14，小程序支付:15，微信正扫(直连):16，微信app支付(直连):17，银联app支付:18，微信H5支付(直连):19，银联H5支付:20，支付宝app支付(直连):21，支付宝H5支付(直连):22 |
| 用户T1取现基准手续费 | userT1BaseFeeAmt | 可选 | feeType为01时必填 格式为#.## |
| 商户T1取现基准手续费 | merT1BaseFeeAmt | 可选 | feeType为01是必填 格式为#.## |
| 线下手续费费率配置 | offlineCalcFeeMode | 可选 | 微信类选填其他扫码类必填 |
| 线上手续费费率配置 | onlineCalcFeeMode | 可选 | 微信类选填其他扫码类为空 |
例：
//字符串格式：(记得内部双引号加转义符)
"[{"feeType":"01","userT1BaseFeeAmt":"1.00","merT1BaseFeeAmt":"1.00"},{"feeType":"20","offlineCalcFeeMode":"AMT*0.0026"},{"feeType":"02","offlineCalcFeeMode":"1.00","onflineCalcFeeMode":"MAX(0.1,AMT*0.0028)"}]"
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000–调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 代理商商户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 商户客户号 | sub_mer_cust_id | 定长16位String | 可选 | 由汇付生成，商户的唯一性标识 |
| 订单号 | order_id | 定长50位String | 必须 | 由商户生成，必须保证唯一， 50位内的字母或数字组合 |
| 订单日期 | order_date | 定长8 位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 子账户号 | acct_id | 变长9位String | 可选 | 基本户-支付账户 |
| 取现绑定银行卡ID | bind_card_id | 变长20位String | 可选 | 取现绑定银行卡ID |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | |
| 商户号 | mer_id | 定长6位String | 必须 | 汇付生成 |
sett01 商户微信支付宝入驻接口¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 支付通道 | pay_way | 定长1位String | 必须 | 1：支付宝 2：微信 |
| 服务商渠道号 | channel_code | 变长128位String | 必须 | 服务商入驻渠道号必填 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 行业分类 | cls_id | 变长10位String | 可选 | 银联MCC,条码、支付宝必填 |
| 经营类目 | category | 变长128位String | 必须 | 微信：微信费率ID（ 微信经营类目和费率id映射表 见附件） 支付宝：支付宝经营类目表 |
| 客服电话 | mer_phone | 变长18位String | 必须 | |
| 省份编码 | province_code | 变长16位String | 必须 | 详见 商户入驻省市区编码 附件 |
| 城市编码 | city_code | 变长16位String | 必须 | 详见 商户入驻省市区编码 附件 |
| 区县编码 | district_code | 变长16位String | 必须 | 详见 商户入驻省市区编码 附件 |
| 经营类型 | business_opera_type | 定长1位String | 必须 | 1：实体 2：虚拟 |
| 商户种类 | business_type | 定长1位String | 必须 |
|
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 商户账户类型 | bk_acct_type | 定长2位String | 必须 | 00:个人银行借记账户,01:个人银行贷记账户,02:个人银行准贷记账户,03:个人支付账户,04:单位支付账户,05:对公银行账户,06:备付金账户,07:存折,99:其他 |
| 申请服务 | service_codes | 变长100位String | 可选 | 申请服务. 微信(JSAPI:JSAPI支付,APPLET:小程序支付,MICROPAY:付款码支付,APP:app支付,MWEB:H5支付,PAP:委托代扣支付,AUTH:授权平台代扣支付),示例值:[“JSAPI”,”APPLET”,”MICROPAY”],默认值为:[“JSAPI”,”APPLET”,”MICROPAY”]。当pay_way=2(微信)时选填，当pay_way=1(支付宝)时无需填写 |
| 银联商户号 | up_merchant_id | 变长15位String | 可选 | 银联商户号 |
| 拟申请的间联商户等级 | indirect_level | 变长20位String | 可选 | INDIRECT_LEVEL_M1:M1等级;INDIRECT_LEVEL_M2:M2等级;INDIRECT_LEVEL_M3:M3等级;INDIRECT_LEVEL_M4:M4等级;不填默认为:INDIRECT_LEVEL_M4 备注: 当pay_way=1(支付宝)时选填，当pay_way=2(微信)时无需填写 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | –调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 商户客户号 | mer_cust_id | 定长16位的String | 必须 | 商户的唯一标识 |
| 支付通道 | pay_way | 定长1位String | 必须 | 1：支付宝 2：微信 |
| 服务商渠道号 | channel_code | 变长64位String | 可选 | 支付宝微信服务商渠道号 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 入驻信息流水号 | platform_seq_id | 变长20位String | 可选 | 异步返回 |
| 二级商户号 | sub_mer_id | 变长16位String | 可选 | 异步返回 |
| 微信支付宝子商户号 | bank_mer_code | 变长20位String | 可选 | 异步返回 |
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
sett02 商户入驻信息修改接口¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 支付通道 | pay_way | 定长1位String | 必须 | 1：支付宝 2：微信 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 服务商渠道号 | channel_code | 变长128位String | 必须 | 服务商入驻渠道号必填 |
| 商户简称 | short_name | 变长25位String | 可选 | |
| 客服电话 | mer_phone | 变长18位String | 可选 | |
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
| 申请服务 | service_codes | 变长100位String | 可选 | 申请服务. 微信(JSAPI:JSAPI支付,APPLET:小程序支付,MICROPAY:付款码支付,APP:app支付,MWEB:H5支付,PAP:委托代扣支付,AUTH:授权平台代扣支付),示例值:[“JSAPI”,”APPLET”,”MICROPAY”],默认值为:[“JSAPI”,”APPLET”,”MICROPAY”]。当pay_way=2(微信)时选填，当pay_way=1(支付宝)时无需填写 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | –调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 支付通道 | pay_way | 定长1位String | 必须 | 1：支付宝 2：微信 |
| 服务商渠道号 | channel_code | 变长128位String | 可选 | 支付宝微信服务商渠道号 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 商户简称 | short_name | 变长10位String | 可选 | |
| 客服电话 | mer_phone | 变长18位String | 可选 | |
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
sett03 商户微信入驻配置接口¶
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为10 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 服务商渠道号 | channel_code | 变长64位String | 可选 | 支付宝微信服务商渠道号 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 配置值 | conf_value | 变长512位String | 必须 | appid:wxxxx,path:https://xxx, subscribeAppid:wxxxx 分别是需要绑定的appid，需要配置的授权目录，推荐关注公众号 |
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | –调用成功，其他见返回码附件表 |
| 应答返回描述 | resp_desc | 变长String | 必须 | 返回码的对应中文描述 |
| 订单号 | order_id | 变长50位String | 必须 | |
| 订单日期 | order_date | 定长8位String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 商户的唯一标识 |
| 服务商渠道号 | channel_code | 变长128位String | 可选 | 支付宝微信服务商渠道号 |
| 费率模式 | rate_type | 定长2位String | 必须 | 01 线上 02 线下 |
| 配置值 | conf_value | 变长512位String | 可选 | appid:wxxxx,path:https://xxx, subscribeAppid:wxxxx 分别是需要绑定的appid，需要配置的授权目录，推荐关注公众号 |
| 异步通知地址 | bg_ret_url | 变长128位String | 可选 | |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
valid3 证件上传认证¶
功能说明¶
适用产品企账通/app+，接口功能说明： 用于上传身份证正反面照片进行实名认证。
- 开通【支付账户】时会对照片做认证
- 本接口上送身份证号必须为用户开户时身份证号保持一致
- 两张身份证照片大小加起来不超过1M
- 如果个人开通支付账户但没有上传证照，交易、提现可能会被风控拦截。如出现相关拦截提示请按要求上传证照
调用方式：后台返回（同步，异步）
调用地址：
请求参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 版本号 | version | 定长2位String | 必须 | 目前固定为 10 |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 证件类型 | cert_type | 定长2位String | 必须 | 证件类型：00－身份证 |
| 身份证号 | cert_id | 变长50位String | 必须 | 身份证号 |
| 证件姓名 | cert_name | 变长50位String | 必须 | |
| 来源渠道 | source_channel | 定长1位String | 必须 | 0-PC;1-ANDROID;2-IOS |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 身份证正面 | cert_front_file | File | 必须 | 传入的中文文件名称为 UTF-8 字符集 URLEncode 编码后的字符串 |
| 身份证反面 | cert_back_file | File | 必须 | 传入的中文文件名称为 UTF-8 字符集 URLEncode 编码后的字符串 |
| 商户私有域 | mer_priv | 变长120位String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 |
| 扩展域 | extension | 变长512位String | 可选 | 用于扩展请求参数 |
返回参数¶
| 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 |
|---|---|---|---|---|
| 应答返回码 | resp_code | 定长6位String | 必须 | C00000上传成功 |
| 应答描述 | resp_desc | 变长String | 必须 | |
| 商户客户号 | mer_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 用户客户号 | user_cust_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 |
| 订单日期 | order_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 |
| 订单号 | order_id | 变长50位String | 必须 | 由商户生成，必须保证唯一，50位内的字母或数字组合 |
| 证件类型 | cert_type | 定长2位String | 必须 | 证件类型：00－身份证 |
| 身份证号 | cert_id | 变长50位String | 必须 | 身份证号 |
| 证件姓名 | cert_name | 变长50位String | 必须 | |
| 来源渠道 | source_channel | 定长1位String | 必须 | 0-PC;1-ANDROID;2-IOS |
| 商户后台应答地址 | bg_ret_url | 变长128位String | 可选 | 通过后台异步通知商户开户结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 |
| 实名验证状态 | check_stat | 定长1位String | 必须 | S-验证通过； F-验证失败； P-验证中； I-未验证。 |