理财类接口 ========== 开通接口 -------- 功能说明 ~~~~~~~~~~~~ 该接口用于开通理财功能 调用方式：系统调用 企业开户先上传图片到汇付的sftp服务器得到对应的FileId 用户名称 及密码联系相关人申请 图片上传的路径按照 /用户名称/pict/图片名称 图片名称： 商户号\ *用户客户号*\ {type}\_{自定义}.jpg 限制长度36位，自定义分段不建议中文 如：NP0561\_6666000000026086\_01\_12.jpg Type对应关系： +--------------+--------------------------+ | type | FileId | +==============+==========================+ | 01 | 开户证件副本FileId | +--------------+--------------------------+ | 02 | 税务登记证副本FileId | +--------------+--------------------------+ | 03 | 组织机构代码副本FileId | +--------------+--------------------------+ | 04 | 法人证件副本FileId | +--------------+--------------------------+ | 05 | 经办人证件FileId | +--------------+--------------------------+ | 06 | 银行开户证明FileId | +--------------+--------------------------+ | 07 | 身份证正面FileId | +--------------+--------------------------+ | 08 | 身份证反面FileId | +--------------+--------------------------+ 请求参数 ~~~~~~~~~~~~~~ +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +==========================+==================================+=====================+===============================+======================================================================================================================================================================================================================================================================================+ | 版本号 | version | 定长2位String | 必须 | 目前固定为10 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 118 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 银行账户名 | bank\_acct\_name | 变长100位String | user\_type为0必填 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 银行卡号 | bank\_no | 变长32位String | user\_type为0必填 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 电子邮件 | user\_email | String | 可选 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 变长20位String | 必须 | 由商户生成，必须保证唯一， | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 身份证有效期 | certid\_valid\_date | 变长8位的String | user\_type为0必填 | 格式为YYYYMMDD，例如：20160307 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 职业 | occupation | 定长2位String | user\_type为0必填 | 职业：00-党政机关/事业单位、21-企业单位、04-金融、20-其他； | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 风险测评域 | user\_protocol\_filed | 变长512位的String | 可选 | 个人的:{"assessResult" : "s1=3&s2=4&s3=1&s4=1&s5=1&s6=1&s7=1&s8=1&s9=1&s10=4", "time" : "20180226100055"} 企业的:{"assessResult" : "s1=3&s2=4&s3=1&s4=1&s5=1&s6=1&s7=1&s8=1&s9=1&s10=4&s11=4&s12=4", "time" : "20180226100055"} 具体参考风险测评文档 个人为10道题目 企业为12道题目 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 尽职调查域 | cust\_research\_filed | 变长512位的String | 可选 | { "taxFlag": "1", "address" : "地址", "birthDate" : "20100909", "taxCountry" : "中国", "taxSId" : "", "reason" : ""} birthDate格式为yyyymmdd | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 用户类型 | user\_type | 定长1位String | 必填 | 0：个人用户；1：企业用户 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 开户证件副本FileId | acct\_open\_lice\_fileid | String36 | user\_type为1必填 | 图片名称仅仅支持JPG 先上传值的汇付的sftp服务器 商户号\ *用户客户号*\ {type}\_{自定义随机数}.jpg 限制长度48位，自定义分段不建议中文 NP0561\_6666000000056735\_01\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 税务登记证副本FileId | tax\_reg\_fileid | String36 | user\_type为1必填 | 图片名称(必须带上图片扩展名jpg) NP0561\_6666000000056735\_02\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 组织机构代码副本FileId | org\_code\_fileid | String36 | user\_type为1必填 | 图片名称(必须带上图片扩展名jpg) NP0561\_6666000000056735\_03\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 法人证件副本FileId | legal\_license\_fileid | String36 | user\_type为1必填 | 图片名称(必须带上图片扩展名jpg) NP0561\_6666000000056735\_04\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人证件FileId | opera\_license\_fileid | String36 | user\_type为1必填 | 图片名称(必须带上图片扩展名jpg) NP0561\_6666000000056735\_05\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 银行开户证明FileId | bank\_acct\_open\_lice\_fileid | String36 | user\_type为1必填 | 图片名称(必须带上图片扩展名jpg) NP0561\_6666000000056735\_06\_12.jpg | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人姓名 | operator\_person | 变长20位的String | user\_type为1必填 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人身份证号码 | operator\_certid | String | user\_type为1必填 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人证件类型 | operator\_certtype | String | user\_type为1必填 | 0：身份证 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人身份证有效期 | operator\_certid\_expires | String | user\_type为1必填 | 格式：YYYYMM,例如20201201 证件长期有效：20991231 | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 经办人手机号 | operator\_mobile | String | user\_type为1必填 | | +--------------------------+----------------------------------+---------------------+-------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +========================+=============================+=====================+=========================+===========================================================================================+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 118 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长6位String | 必须 | 118305: 开通成功、 其他见返回码表 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长18位String | 必须 | 组成规则：8位本平台日期+ 10位系统流水号 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长String | 必须 | 返回码的对应中文描述 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 变长20位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知结果(企业用户会异步通知) 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 职业 | occupation | 定长2位String | 必须 | 职业 00：党政机关/事业单位、21：企业单位、04：金融、20：其他 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 风险测评域 | user\_protocol\_filed | 变长512位的String | 可选 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 尽职调查域 | cust\_research\_filed | 变长512位的String | 可选 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 经办人姓名 | operator\_person | 变长20位的String | user\_type为1必填 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 经办人身份证号码 | operator\_certid | String | user\_type为1必填 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 经办人证件类型 | operator\_certtype | String | user\_type为1必填 | 0：身份证 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 经办人身份证有效期 | operator\_certid\_expires | String | user\_type为1必填 | 格式：YYYYMM,例如20201201 证件长期有效：20991231 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 经办人手机号 | operator\_mobile | String | user\_type为1必填 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 银行账户名 | bank\_acct\_name | 变长100位String | 可选 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ | 银行卡号 | bank\_no | 变长32位String | 可选 | | +------------------------+-----------------------------+---------------------+-------------------------+-------------------------------------------------------------------------------------------+ 商户后台应答返回参数 ~~~~~~~~~~~~~~~~~~~~~~~~ 备注：审核之后通知，仅**企业开户**才有异步返回 +--------------+--------------+------------+------------+------------+-----------------------------------+ | **参数** | **中文名** | **定义** | **长度** | **非空** | **说明** | +==============+==============+============+============+============+===================================+ | respCode | 返回码 | string | | | | +--------------+--------------+------------+------------+------------+-----------------------------------+ | respDesc | 返回描述 | string | | | | +--------------+--------------+------------+------------+------------+-----------------------------------+ | userCustId | 客户号 | string | | | | +--------------+--------------+------------+------------+------------+-----------------------------------+ | merCustId | 商户号 | String | | | | +--------------+--------------+------------+------------+------------+-----------------------------------+ | trdStatus | 开户结果 | string | | | 成功：S 处理中：P 失败：F | +--------------+--------------+------------+------------+------------+-----------------------------------+ | reqFlag | 请求类型 | string | | | 新增：1 修改：2 | +--------------+--------------+------------+------------+------------+-----------------------------------+ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "118", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000072600", "bank_acct_name": "张三", "bank_no": "6222031752341267", "user_email": "8312341234@qq.com", "order_date": "20180816", "order_id": "201808161308536194", "bg_ret_url": "http://192.168.0.74:8001/npayCallBack/asyncHandle.json", "mer_priv": "商户私有域随便填写", "extension": "扩展域随便填写", "certid_valid_date": "20190707", "occupation": "00", "user_protocol_filed": "", "cust_research_filed": "", "user_type": "0", "acct_open_lice_fileid": "", "tax_reg_fileid": "", "org_code_fileid": "", "legal_license_fileid": "", "opera_license_fileid": "", "bank_acct_open_lice_fileid": "", "operator_person": "", "operator_certid": "", "operator_certtype": "", "operator_certid_expires": "", "operator_mobile": "" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "118"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "118", "resp_code": "118000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "118", "resp_code": "118099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 返回码 ~~~~~~~~~ +---------------------------------------+------------------------------------------------------+ | **开通理财（cmd\_id=118）** | | +=======================================+======================================================+ | 118330 | 您的开通请求已经受理，一个工作日后会返回审核结果。 | +---------------------------------------+------------------------------------------------------+ | 118305 | 开通生利宝账户成功 | +---------------------------------------+------------------------------------------------------+ | 118102 | 验证签名失败 | +---------------------------------------+------------------------------------------------------+ | 118103 | 商户状态异常 | +---------------------------------------+------------------------------------------------------+ | 118104 | 用户状态异常 | +---------------------------------------+------------------------------------------------------+ | 118107 | 消息类型与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 118108 | 商户客户号与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 118109 | 版本号与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 118304 | 开通生利宝账户失败 | +---------------------------------------+------------------------------------------------------+ | 118340 | 请联系管理员,配置SFTP服务!!! | +---------------------------------------+------------------------------------------------------+ | 118339 | 银行开户证明图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118338 | 经办人证件图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118337 | 法人证件副本图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118336 | 组织机构代码副本图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118335 | 税务登记证副本图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118334 | 开户证件副本图片格式名称错误 | +---------------------------------------+------------------------------------------------------+ | 118226 | 该账户开户处理中，请勿重复提交 | +---------------------------------------+------------------------------------------------------+ | 118099 | 系统异常 | +---------------------------------------+------------------------------------------------------+ | 118202 | 交易订单号重复 | +---------------------------------------+------------------------------------------------------+ 关闭接口 -------- 功能说明 ~~~~~~~~ 商户下用户关闭生利宝接口 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +====================+==================+=====================+============+=======================================================================+ | 版本号 | version | 定长2位String | 必须 | 目前固定为10 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 119 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 订单号 | order\_id | 变长20位String | 必须 | 由商户生成，必须保证唯一， | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +========================+=====================+=====================+============+=======================================================================+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 119 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长6位String | 必须 | 119308—关闭成功 其他见返回码表 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长String | 必须 | 返回码的对应中文描述 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 可选 | 由汇付生成，用户的唯一性标识 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 订单号 | order\_id | 变长20位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长18位String | 必须 | 组成规则：8位本平台日期+ 10位系统流水号 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "119", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000072600", "order_date": "20180816", "order_id": "2018081613100075", "bg_ret_url": "http://192.168.0.74:8001/npayCallBack/asyncHandle.json", "mer_priv": "商户私有域随便填写", "extension": "扩展域随便填写" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "119"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "119", "resp_code": "119000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "119", "resp_code": "119099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 返回码 ~~~~~~~~~ +---------------------------------------+------------------------------------------------------+ | **关闭理财（cmd\_id=119）** | | +---------------------------------------+------------------------------------------------------+ | 119099 | 系统异常 | +---------------------------------------+------------------------------------------------------+ | 119100 | 请求参数非法 | +---------------------------------------+------------------------------------------------------+ | 119101 | 商户无此接口权限 | +---------------------------------------+------------------------------------------------------+ | 119102 | 验证签名失败 | +---------------------------------------+------------------------------------------------------+ | 119103 | 商户状态异常 | +---------------------------------------+------------------------------------------------------+ | 119104 | 用户状态异常 | +---------------------------------------+------------------------------------------------------+ | 119107 | 消息类型与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 119108 | 商户客户号与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 119109 | 版本号与签名内容不一致 | +---------------------------------------+------------------------------------------------------+ | 119308 | 关闭生利宝账户成功 | +---------------------------------------+------------------------------------------------------+ | 119309 | 生利宝账户已经关闭 | +---------------------------------------+------------------------------------------------------+ | 119202 | 交易订单号重复 | +---------------------------------------+------------------------------------------------------+ 申购接口 -------- 功能说明 ~~~~~~~~ 供商户查询其用户在本平台进行过的交易的交易状态 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +====================+==================+=====================+====================+================================================================================================================================================================+ | 版本号 | version | 定长2位String | 必须 | 默认为10，可扩展 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长String | 必须 | 224 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 汇付生成，唯一 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 定长20位String | 必须 | 商户系统生成，商户下唯一 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8 位String | 必须 | YYYYMMDD | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 客户号 | user\_cust\_id | 变长16位的String | 必须 | 汇付生成，用户的唯一性标识 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 出款账户 | out\_acct\_id | 变长9位的String | 必须 | | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 申购金额 | purchase | 变长14位的String | 必须 | 泛指交易金额，如充值、支付、取现、冻结和解冻金额（金额格式必须是###.00）比如2.00，2.01 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知，商户网站都应在应答接收页面输出RECV\_ORD\_ID字样的字符串，表明商户已经收到该笔交易结果 注意： 1) 使用时请注意不要包含中文 2) 必须是外网地址 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 否 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 注意： 如果该字段中包含了中文字符请对该字段的数据进行Base64加密后再使用 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入参扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+------------------+---------------------+--------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +========================+=====================+=====================+============+================================================================================================================================================================+ | 消息类型 | cmd\_id | 变长String | 必须 | 224 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长6位的String | 必须 | 成功返回224000 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答描述 | resp\_desc | 变长String | 必须 | | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 汇付生成，唯一 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 变长16位的String | 必须 | 汇付生成，用户的唯一性标识 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 定长20位String | 必须 | 商户系统生成，商户下唯一 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8 位String | 必须 | YYYYMMDD | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长18位String | 必须 | 组成规则：8位本平台日期+ 10位系统流水号 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 转账金额 | purchase\_amt | 变长14位的String | 必须 | 泛指交易金额，如充值、支付、取现、冻结和解冻金额（金额格式必须是###.00）比如2.00，2.01 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知，商户网站都应在应答接收页面输出RECV\_ORD\_ID字样的字符串，表明商户已经收到该笔交易结果 注意： 1) 使用时请注意不要包含中文 2) 必须是外网地址 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 返参扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------------+---------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "224", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000040420", "order_date": "20180118", "order_id": "20180218510102", "purchase_amt": "0.58", "out_acct_id": "97095", "bg_ret_url": "http://loasi.com" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "224"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "224", "resp_code": "224000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "224", "resp_code": "224099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 赎回接口 -------- 功能说明 ~~~~~~~~ 供商户查询其用户在本平台进行过的交易的交易状态 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +====================+==================+=====================+============+================================================================================================================================================================+ | 版本号 | Version | 定长2位String | 必须 | 默认为10，可扩展 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长String | 必须 | 225 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 汇付生成，唯一 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 定长20位String | 必须 | 商户系统生成，商户下唯一 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8 位String | 必须 | YYYYMMDD | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 客户号 | user\_cust\_id | 变长16位的String | 必须 | 汇付生成，用户的唯一性标识 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入款账户 | in\_acct\_id | 变长9位的String | 必须 | | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 赎回金额 | redeem\_amt | 变长14位的String | 必须 | 泛指交易金额，如充值、支付、取现、冻结和解冻金额（金额格式必须是###.00）比如2.00，2.01 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 通过后台异步通知，商户网站都应在应答接收页面输出RECV\_ORD\_ID字样的字符串，表明商户已经收到该笔交易结果 注意： 1) 使用时请注意不要包含中文 2) 必须是外网地址 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 注意： 如果该字段中包含了中文字符请对该字段的数据进行Base64加密后再使用 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入参扩展域 | Extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +========================+=====================+=====================+============+==========================================================================================+ | 消息类型 | cmd\_id | 变长String | 必须 | 225 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长6位的String | 必须 | 成功：225000 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 应答描述 | resp\_desc | 变长String | 必须 | | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 汇付生成，唯一 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 客户号 | user\_cust\_id | 变长16位的String | 必须 | 汇付生成，用户的唯一性标识 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 定长20位String | 必须 | 商户系统生成，商户下唯一 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长8 位String | 必须 | YYYYMMDD | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长18位String | 必须 | 组成规则：8位本平台日期+ 10位系统流水号 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 转账金额 | redeem\_amt | 变长14位的String | 必须 | 泛指交易金额，如充值、支付、取现、冻结和解冻金额（金额格式必须是###.00）比如2.00，2.01 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 必须 | 后台异步通知商户开户结果 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ | 返参扩展域 | Extension | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------------+---------------------+---------------------+------------+------------------------------------------------------------------------------------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "225", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000040420", "order_date": "20180117", "order_id": "201801175001102", "redeem_amt": "0.29", "in_acct_id": "97095", "bg_ret_url": "http://loasi.com" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "225"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "225", "resp_code": "225000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "225", "resp_code": "225099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 交易明细查询接口 ---------------- 功能说明 ~~~~~~~~ 查询商户下申购赎回交易明细 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | **参数中文名称** | **参数名称** | **数据格式** | **是否必须** | **说明** | +====================+==================+======================+================+==========================================================+ | 版本号 | version | 定长2位String | 必须 | 目前固定为10 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为307 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 商户的唯一标识 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 用户标识 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 开始日期 | begin\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 （最多查询100天） | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 结束日期 | end\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 交易查询类型 | trans\_type | 定长2位String | 必须 | 申购：10 赎回：11 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120 位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+------------------+----------------------+----------------+----------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | **参数中文名称** | **参数名称** | **数据格式** | **是否必须** | **说明** | +=============================+==================+=====================+================+==========================================================+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为307 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 商户的唯一标识 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 返回码 | resp\_code | 定长3位String | 必须 | 000：成功 099：系统异常 213：订单信息不存在 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 返回内容 | resp\_desc | 变长String | 可选 | | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 交易明细 | trans\_detail | 变长String | 必须 | 数据格式：json串 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 总数 | Total\_num | 变长String | 是 | 总条数 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +-----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ **交易明细（trans\_detail)** +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 订单号 | order\_id | 变长20位String | 必须 | 由商户生成，必须保证唯一， 20位内的字母或数字组合 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 订单日期 | order\_date | 定长8位String | 必须 | 格式为YYYYMMDD，例如：20160307 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 交易查询类型 | trans\_type | 定长2位String | 必须 | 申购：10 赎回：11 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 汇付交易状态 | transfer\_stat | 变长8位的String | 可选 | 成功 00 失败01 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 交易金额 | transfer\_amt | 变长14位的String | 可选 | 泛指交易金额，金额格式必须是###.00，比如2.00，2.01 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ | 分账账户串 | div\_detail | 变长String | 可选 | 数据格式：json串 | +----------------------------+------------------+---------------------+----------------+----------------------------------------------------------+ **分账账户串（div\_detail）** +--------------------+----------------+--------------------+----------------+--------------------------+ | **参数中文名称** | **参数名称** | **数据格式** | **是否必须** | **说明** | +====================+================+====================+================+==========================+ | 分账客户号 | divCustId | 定长16位的String | 必须 | | +--------------------+----------------+--------------------+----------------+--------------------------+ | 分账账户号 | divAcctId | 变长9位String | 必须 | | +--------------------+----------------+--------------------+----------------+--------------------------+ | 分账金额 | divAmt | 变长14位String | 必须 | 分账金额，保留两位小数 | +--------------------+----------------+--------------------+----------------+--------------------------+ | 冻结标记 | divFreezeFg | 定长2位String | 必须 | 不冻结：00 冻结：01 | +--------------------+----------------+--------------------+----------------+--------------------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "307", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000056735", "begin_date": "20180102", "end_date": "20180131", "trans_type": "10", "mer_priv": "mer_priv", "extension": "extension" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "307"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "307", "resp_code": "307000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "307", "resp_code": "307003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 收益查询接口 ------------ 功能说明 ~~~~~~~~ 提供给商户平台查询商户下生利宝理财收益明细； 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | **字段名** | **参数中文名称** | **数据格式** | **是否必须** | **说明** | +==================+====================+=====================+================+=============================================================+ | version | 版本号 | 定长2位String | 必须 | 目前固定为10 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | cmd\_id | 消息类型 | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为308 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | mer\_cust\_id | 商户号 | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | user\_cust\_id | 用户号 | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 （查法人用户时填法人用户号） | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | begin\_date | 开始时间 | 定长8 位String | 可选 | YYYYMMDD查询时间 不超过365天；不传默认查前一天 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | end\_date | 结束时间 | 定长8 位String | 可选 | YYYYMMDD查询时间 每次最多查询100条记录 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | mer\_priv | 商户私有域 | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ | extension | 扩展域 | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------+--------------------+---------------------+----------------+-------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | **参数中文名称** | **参数中文名称** | **数据格式** | **是否必须** | **说明** | +====================+====================+=========================+================+====================================================================================================================================+ | cmd\_id | 消息类型 | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为308 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | respCode | 应答返回码 | 定长6位的String | 必须 | | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | respDesc | 应答描述 | 变长String | 必须 | | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | mer\_cust\_id | 商户号 | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | user\_cust\_id | 用户号 | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | profit\_ detail | 收益信息 | 变长String （json串） | 必须 | 格式：[{incomedate:'20171212', incomeamt:'123.00', annurate:'3%'}, { incomedate: '20171213', incomeamt:'123.00', annurate:'3%'}] | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | total\_num | 记录数 | 变长3位String | 必须 | 总录数 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | mer\_priv | 商户私有域 | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | extension | 扩展域 | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | **profit\_ detail**| | | | | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | incomedate | 收益到账日期 | 定长8位的String | 可选 | yyyyMMdd | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | incomeamt | 收益金额 | 变长String | 可选 | 单位：元,精确到分，如123.00 | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ | annurate | 7日年化收益率 | 变长String | 可选 | % | +--------------------+--------------------+-------------------------+----------------+------------------------------------------------------------------------------------------------------------------------------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "308", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000056735", "begin_date": "20180102", "end_date": "20180131", "mer_priv": "mer_priv", "extension": "extension" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "308"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "308", "resp_code": "308000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "308", "resp_code": "308099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 收益率查询接口 -------------- 功能说明 ~~~~~~~~ 提供给商户平台查询商户下生利宝理财收益率明细 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | **字段名** | **参数中文名称** | **数据格式** | **是否必须** | **说明** | +==================+====================+=====================+================+==========================================================+ | version | 版本号 | 定长2位String | 必须 | 目前固定为10 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | cmd\_id | 消息类型 | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为309 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | mer\_cust\_id | 商户号 | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | user\_cust\_id | 用户号 | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | days | 查询天数 | 定长2位String | 可选 | 查询天数 1-31，默认为 1 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | mer\_priv | 商户私有域 | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ | extension | 扩展域 | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------+--------------------+---------------------+----------------+----------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~~~ +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | **参数中文名称** | **参数中文名称** | **数据格式** | **是否必须** | **说明** | | +====================+====================+=====================+================+==========================================================+============+ | cmd\_id | 消息类型 | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为309 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | respCode | 应答返回码 | 定长6位的String | 必须 | | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | respDesc | 应答描述 | 变长String | 必须 | | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | mer\_cust\_id | 商户号 | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | user\_cust\_id | 用户号 | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | rate\_detail | 收益率信息 | 变长string | 必须 | 格式：json串 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | mer\_priv | 商户私有域 | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | extension | 扩展域 | 变长512位的String | 可选 | 用于扩展请求参数 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | total\_num | 记录数 | 变长3位String | 必须 | 总录数 | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | **rate\_detail** | | | | | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | prddate | 日期 | 定长8位String | 可选 | yyyyMMdd | 多条记录 | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | prdrate | 每万份收益率 | 变定String | 可选 | % | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ | annurate | 7日年化收益率 | 变长String | 可选 | % | | +--------------------+--------------------+---------------------+----------------+----------------------------------------------------------+------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "309", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000056735", "days": "5", "mer_priv": "mer_priv", "extension": "extension" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "309"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "309", "resp_code": "309000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "309", "resp_code": "309099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 生利宝余额查询接口 ------------------ 功能说明 ~~~~~~~~ 提供商户查询生利宝账户当前余额 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +----------------+------------------+------------------+------------+-----------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +================+==================+==================+============+=========================================+ | 版本号 | version | 定长2位String | 必须 | 目前固定为10 | +----------------+------------------+------------------+------------+-----------------------------------------+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为314 | +----------------+------------------+------------------+------------+-----------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 商户的唯一标识 | +----------------+------------------+------------------+------------+-----------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 查询商户本身时，同商户客户号 | +----------------+------------------+------------------+------------+-----------------------------------------+ 返回参数 ~~~~~~~~~~~~ +----------------+-----------------+------------------+------------+-----------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +================+=================+==================+============+=========================================+ | 消息类型 | cmdId | 定长3位String | 必须 | 每一种消息类型代表一种交易，此处为314 | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 返回码 | respCode | 定长3位String | 必须 | 000：成功 099：系统异常 | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 返回内容 | respDesc | 变长String | 可选 | | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 商户客户号 | merCustId | 定长16位String | 必须 | 商户的唯一标识 | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 用户客户号 | userCustId | 定长16位String | 必须 | 查询商户本身时，同商户客户号 | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 商户可用余额 | balance | 变长String | 必须 | | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 商户账户余额 | acctBalance | 变长String | 必须 | | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 商户冻结余额 | freezeBalance | 变长String | 必须 | | +----------------+-----------------+------------------+------------+-----------------------------------------+ | 商户账户状态 | acctStat | 定长1位 | 必须 | N:正常 C:关闭 F:冻结 D:销户 | +----------------+-----------------+------------------+------------+-----------------------------------------+ 返回码 ~~~~~~~~~ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{"version":"10","cmd_id":"314","mer_cust_id":"6666000000026086","user_cust_id":"6666000000072600"}"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "314"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "314", "resp_code": "314000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "314", "resp_code": "314003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 风险测评题目接口 ---------------- 功能说明 ~~~~~~~~ 开通理财功能时，商户需要调用风险测评题目接口； 调用方式：接口返回 请求参数 ~~~~~~~~~~~~~~ +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +====================+==================+=====================+============+=======================================================================+ | 版本号 | version | 定长2位String | 必须 | 目前固定为10 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 312 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 可选 | 通过后台异步通知结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +--------------------+------------------+---------------------+------------+-----------------------------------------------------------------------+ 返回参数 ~~~~~~~~~~~~ +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 参数中文名称 | 参数名称 | 数据格式 | 是否必须 | 说明 | +========================+=====================+=====================+============+=======================================================================+ | 消息类型 | cmd\_id | 定长3位String | 必须 | 312 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长6位String | 必须 | 312000—成功 其他见返回码表 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长18位String | 必须 | 组成规则：8位本平台日期+ 10位系统流水号 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长String | 必须 | 返回码的对应中文描述 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长16位String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长16位String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户后台应答地址 | bg\_ret\_url | 变长128位的String | 可选 | 通过后台异步通知结果 注意： 1) 使用时不要包含中文 2) 必须是外网地址 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 商户私有域 | mer\_priv | 变长120位的String | 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 扩展域 | extension | 变长512位的String | 可选 | 用于扩展请求参数 | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 风险测评串 | riskJson | jsonString | 必须 | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ **风险测评串（riskJson）** +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | **riskJson** | | | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 问题 | Q | String | 必须 | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 答案A | A | String | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 答案B | B | String | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 答案C | C | String | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 答案D | D | String | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 答案E | E | String | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ | 序号 | order | int | | | +------------------------+---------------------+---------------------+------------+-----------------------------------------------------------------------+ 代码示例 ~~~~~~~~~ java .. code:: java String valueObj = "{ "version": "10", "cmd_id": "312", "mer_cust_id": "6666000000026086", "user_cust_id": "6666000000072600", "bg_ret_url": "http://192.168.0.74:8001/npayCallBack/asyncHandle.json", "mer_priv": "商户私有域随便填写", "extension": "扩展域随便填写" }"; String testUrl = "http://192.168.3.170:8083/npay/merchantRequest"; String checkValue = sign(valueObj); String cmdId = "312"; String merCustId = "6666000000026086"; String version = "10"; String contentType = "application/x-www-form-urlencoded"; String charset = "UTF-8"; String postStr = "cmd_id=" + cmdId + "&version=" + version + "&mer_cust_id=" + merCustId + "&check_value=" + checkValue; jodd.http.HttpRequest httpRequest = jodd.http.HttpRequest.post(testUrl).charset(charset); jodd.http.HttpResponse httpResponse = httpRequest.contentType(contentType).body(postStr).send(); String body = httpResponse.bodyText(); String resultObj = parseResult(body);//解密 .. 成功响应： .. code:: json 200 { "cmd_id": "312", "resp_code": "312000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } .. 失败响应： .. code:: json 200 { "cmd_id": "312", "resp_code": "312099", "resp_desc": "交易失败", "mer_cust_id" : "6666000000026086", "order_date": "20180327", "order_id": "10000000001", ....... } 返回码 ~~~~~~~~~ +---------------------------------------+------------------------------------------------------+ | **风险测评题目接口（cmd\_id=312）** | | +---------------------------------------+------------------------------------------------------+ | 312000 | 成功 | +---------------------------------------+------------------------------------------------------+ | 312099 | 系统异常 | +---------------------------------------+------------------------------------------------------+ | 312331 | 风险测评域参数错误!!!! | +---------------------------------------+------------------------------------------------------+ | 312332 | 尽职调查域参数错误!!!! | +---------------------------------------+------------------------------------------------------+