用户业务查询

请求参数

  • 请求地址

https://spin.cloudpnr.com/ssproxy/queryUserDetail

  • 公共请求参数

请求报文头HEADER - 「接口规则-参数规定-报文头」 ，请求报文体BODY - 「接口规则-参数规定-报文体」 ，响应报文体 - 「接口规则-参数规定-响应报文体」

  • 请求参数(data)
参数 中文名 类型 必填 最大长度 说明
req_seq_id 请求流水号 String Y 32 请求流水号
req_date 请求时间 String Y 8 请求时间YYYYMMDD
huifu_id 汇付ID String Y 18  
product_id 产品编号 String Y 32 若不传入，则只查询基本信息；若传入则查询详细信息

响应参数

  • 同步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
resp_code 网关返回码 String Y 5 网关返回码
resp_desc 网关返回描述 String Y 512 网关返回描述
sign 签名 String Y   签名，对报文整体签名
data 交易响应内容体 String N   务返回参数
  • 异步响应参数(data)
参数 中文名 类型 必填 最大长度 说明
resp_code 网关返回码 String Y 5 网关返回码
resp_desc 网关返回描述 String Y 512 网关返回描述
ent_base_info 企业用户基本信息 Object N    
indv_base_info 个人用户基本信息 Object N    
card_info 结算卡信息 Object N    
settle_config 结算信息配置 Object N    
qry_cash_config_list 取现配置列表 json N    
file_list 文件列表 json N   附件资料列表fileList
  • ent_base_info(企业用户基本信息)
参数 中文名 类型 必填 最大长度 说明
reg_name 企业用户名称 String Y 128 当为汉字时，以2个字符计算
license_code 营业执照编号 String Y 20  
license_validity_type 证照有效期类型 String Y 1 1:长期有效 0:非长期有效
license_begin_date 证照有效期起始日期 String Y 8 yyyyMMdd
license_end_date 证照有效期结束日期 String N 8 yyyyMMdd
reg_prov_id 注册地址(省) String Y 6  
reg_area_id 注册地址(市) String Y 6  
reg_district_id 注册地址(区) String Y 6  
reg_detail 注册地址(详细信息) String Y 256  
legal_name 法人姓名 String Y 32  
legal_cert_type 法人证件类型 String Y 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证 12:营业执照
legal_cert_no 法人证件号码 String Y 32  
legal_cert_validity_type 法人证件有效期类型 String Y 1 1:长期有效 0:非长期有效
legal_cert_begin_date 法人证件有效期开始日期 String Y 8 yyyyMMdd
legal_cert_end_date 法人证件有效期截止日期 String N 8 yyyyMMdd
contact_name 联系人姓名 String Y 32  
contact_mobile_no 联系人手机号 String Y 11  
contact_email 联系人电子邮箱 String N 64  
login_name 管理员账号 String N 32  
file_list 附件资料列表 json N U 附件资料列表fileList
  • indv_base_info(个人用户基本信息)
参数 中文名 类型 必填 最大长度 说明
name 个人姓名 String Y 32  
cert_type 个人证件类型 String Y 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证 12:营业执照
cert_no 个人证件号码 String Y 32  
cert_validity_type 个人证件有效期类型 String Y 1 1:长期有效 0:非长期有效
cert_begin_date 个人证件有效期开始日期 String Y 8 yyyyMMdd
cert_end_date 个人证件有效期截止日期 String N 8 yyyyMMdd
mobile_no 手机号 String Y 11  
email 电子邮箱 String N 64  
login_name 管理员账号 String N 32  
file_list 附件资料列表 json N U 附件资料列表fileList
  • settle_config(结算配置)
参数 中文名 类型 必填 最大长度 说明
settle_cycle 结算周期 String Y 2 T1 D1
min_amt 起结金额 String N 14,2 整数最多14位，小数最多两位
remained_amt 留存金额 String N 14,2 整数最多14位，小数最多两位
settle_abstract 结算摘要 String N 128 默认为空，如果需要自定义结算打款备注，请使用此字段传入，字段类型为字符串
out_settle_flag 手续费外扣标记 String N 1 1:外扣 2:内扣
out_settle_huifuid 结算手续费外扣时的汇付ID String N 16 yyyyMMdd
fixed_ratio 节假日结算手续费率 String N 3,2 T1时无意义，D1时节假日按此费率结算
settle_batch_no 结算批次号 String N   0(0点昨日余额结算批次)300(3点余额结算批次)600(6点余额结算批次)900(9点余额结算批次)
  • card_info(卡信息)
参数 中文名 类型 必填 最大长度 说明
card_type 卡类型 String Y 1 0:对公 1:对私
card_name 卡户名 String Y 128  
card_no 卡号 String Y 32  
prov_id 银行所在市 String Y 6  
area_id 银行所在省 String Y 6  
bank_code 银行号 String N 8  
branch_code 支行联行号 String N 12 对公时必传
branch_name 支行名称 String N 64 对公时必传
cert_type 持卡人证件类型 String N 2 00:身份证 01:护照 02:军官证 03:士兵证 04:回乡证 05:户口本 06:外国护照 07:其他 08:暂住证 09:警官证 10:文职干部证 11:港澳同胞回乡证
cert_no 持卡人证件号码 String N 32  
cert_validity_type 持卡人证件有效期类型 String N 1 1:长期有效 0:非长期有效
cert_begin_date 持卡人证件有效期（起始） String N 8 yyyyMMdd
cert_end_date 持卡人证件有效期（截止） String N 8 yyyyMMdd
mp 银行卡绑定手机号 String N 11  
  • qry_cash_config_list(取现配置列表)
参数 中文名 类型 必填 最大长度 说明
cash_type 业务类型 String N 2 D0:D0取现
switch_state 开关状态 String N 128 0:关闭 1:开通
fix_amt 提现手续费（固定/元） String N 16,2 开通提现业务时必须填写一种收费方式
fee_rate 费率（百分比/%） String N 16,2 开通提现业务时必须填写一种收费方式

file_list(附件资料列表)

参数 中文名 类型 必填 最大长度 说明
file_type 文件类型 String Y 8  
file_id 文件jfileID String Y 128  
file_name 文件名称 String N 128  

请求示例

{
  "sys_id":"ssproxy_dev",
  "data":"{\"req_seq_id\":\"rQ20210820111247335641007823920\",\"req_date\":\"20210820\",\"huifu_id\":\"6666000103850489\",\"product_id\":\"\"}",
  "sign":"LnngrNLkKr6+jUtz5EpLUQkNyTfHBBNMGIvBQ/Sh1eLzjr1yUDEYmFOkyqRCYQdsVI5+1GzKK87fCVCNWl3bq2Htp4+61Rwh5L1fjeM64lyoVYlFxWvKHbVGKQUYQi+FLns5hqxzcy0t2SlfpyEeuAf/UP3K+e6WUqHJw7EHPuU=",
  "sign_type":"RSA2"
}

响应示例

{"data":"{\"sub_resp_code\":\"00000000\",\"ent_base_info\":{\"contact_name\":\"花朵\",\"legal_cert_type\":\"01\",\"legal_cert_end_date\":\"20301010\",\"file_list\":[{\"file_name\":\"企业营业执照1.jpg\",\"file_type\":\"F01\",\"file_id\":\"2021081311281594793345511\"}],\"reg_area_id\":\"310100\",\"license_validity_type\":\"1\",\"legal_cert_begin_date\":\"20121010\",\"contact_email\":\"mei.zhang@huifu.com\",\"reg_district_id\":\"310104\",\"license_end_date\":\"\",\"legal_cert_validity_type\":\"0\",\"license_begin_date\":\"20200117\",\"login_name\":\"Lg2021080903410397581\",\"legal_cert_no\":\"321084198912066512\",\"contact_mobile_no\":\"13764462288\",\"reg_prov_id\":\"310000\",\"reg_name\":\"企业商户名称3435\",\"legal_name\":\"陈立健\",\"reg_detail\":\"上海市宜山路\",\"license_code\":\"2021080903410367\"},\"sub_resp_desc\":\"成功\"}","resp_desc":"成功调用","resp_code":"10000","sign":"hGk7rKO0kGcDAZTIjfjQPDTI0GOCCrVhuAhoqQF0Gf7t7fTQ8pPCX0wzjMIF/L5HhqG7KSzbfoh+vzcC5yVbrBTLVdwpT9/9v/UQkP/8gr50E2yZonnvsWOo6aORMCjGV9VzD8wPvwfV5iEZJMMXwy008PU3lwVEnk8hnch3woQ="}

接口调用示例

Demo参考