查询类 ====== 余额查询 -------- 接口功能说明 ~~~~~~~~~~~~ 供商户查询其用户在本平台专属账户的可用余额 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==============+==================+===================+============+=======================================================================================+ | 版本号 | version | 定长 2 位 String | 必须 | 目前固定为 10 | +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 302 | +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +--------------+------------------+-------------------+------------+---------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+ mer_cust_id+user_cust_id 返回参数列表 ~~~~~~~~~~~~ +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==============+===================+===================+============+=======================================================================================+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 302 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 返回码 | resp\_code | 变长 String | 必须 | 302000--调用成功 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 结果描述 | resp\_desc | 变长 String | 必须 | 返回码对应的中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文| +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 用户客户号 | user\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 可用余额 | balance | 变长 14 位 String | 可选 | 账户可以转账的余额 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 可取现余额 | cash\_balance | 变长 14 位 String | 可选 | 账户可以取现的余额 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 账户余额 | acct\_balance | 变长 14 位 String | 可选 | 账户户资金余额，该余额能真正反映账户的资金量 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 冻结余额 | freeze\_balance | 变长 14 位 String | 可选 | 冻结余额 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +--------------+-------------------+-------------------+------------+---------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+mer_cust_id+user_cust_id+balance+cash_balance+acct_balance+freeze_balanace 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "302")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "302", "resp_code": "302000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "302", "resp_code": "302003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 302000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302010 | 记录不存在 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 302106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ 交易状态查询 ------------ 接口功能说明 ~~~~~~~~~~~~ 供商户查询某笔交易的状态，支持两段式交易状态查询 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==================+====================+=====================+============+==========================================================================================================================================================+ | 版本号 | version | 定长 2 位 String | 必须 | 目前固定为 10 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 306 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长 8 位的 String | 可选 | 格式为 YYYYMMDD，例如：20160307 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 变长 20 位的 String | 可选 | 由商户生成，必须保证唯一，20 位内的字母或数字组合 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易流水号 | biz\_trans\_id | 变长 20 位 String | 可选 | 订单号跟交易流水至少传一个。如果传此参数，则表示查询两段式交易（发短信阶段跟验短信阶段）结果 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易查询类型 | trans\_type | 定长 8 位 String | 必须 | 05000100：充值/支付； 05000101：取现； 05000102：转账： 05000103：扫码支付； 05000104：退款； 05000105：微信公众号支付； 05000106：支付宝统一下单支付 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易查询子类型 | sub\_trans\_type | 定长 8 位 String | 可选 | 预留字段，可不传 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ | 签名 | check\_value | 定长 256 位的 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +------------------+--------------------+---------------------+------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+mer_cust_id+order_date+order_id+biz_trans_id+trans_type+sub_trans_type 返回参数列表 ~~~~~~~~~~~~ +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +========================+=====================+=====================+============+======================================================================================================================================================================================+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 306 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 返回码 | resp\_code | 变长 String | 可选 | 306000--调用成功 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 结果描述 | resp\_desc | 变长 String | 可选 | 返回码对应的中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位的 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单日期 | order\_date | 定长 8 位的 String | 可选 | 格式为YYYYMMDD，例如：20160307 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 订单号 | order\_id | 变长 20 位的 String | 可选 | 由商户生成，必须保证唯一，20 位内的字母或数字组合 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易流水号 | biz\_trans\_id | 变长 20 位 String | 可选 | 请求参数交易流水号 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易查询类型 | trans\_type | 定长 8 位 String | 必须 | 请求参数交易查询类型 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易查询子类型 | sub\_trans\_type | 定长 8 位 String | 可选 | 请求参数交易查询子类型 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 两段式交易明细 | result\_list | 变长 512 位 String | 可选 | [{trans\_stat:"02000002",platform\_seq\_id："201712111111111111"，trans\_amt:"1.00",fee\_amt:"0.01",fee\_acct\_id:"1111",trans\_resp\_code:"201000",trans\_resp\_desc:"交易成功"}] | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易状态 | trans\_stat | 定长 8 位 String | 必须 | 交易状态 02000001：已受理； 02000002：成功； 02000003：失败；02000005：处理中； 02000006：部分成功(充值成功，支付失败) | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长 18 位 String | 必须 | 组成规则：8 位本平台日期 +10 位系统流水号 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易金额 | trans\_amt | 定长 14 位的 String | 必须 | 交易金额，格式为###.00 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费 | fee\_amt | 定长 14 位的 String | 可选 | 手续费金额，格式为###.00 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费收取账户 | fee\_acct\_id | 变长 9 位 String | 可选 | 手续费收取子账户 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易返回码 | trans\_resp\_code | 定长 6 位 String | 可选 | 交易接口的返回码 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易返回描述 | trans\_resp\_desc | 变长 String | 可选 | 交易返回码对应的中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 签名 | check\_value | 定长 256 位的 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +------------------------+---------------------+---------------------+------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+mer_cust_id+order_date+order_id+biz_trans_id+trans_type+sub_trans_type 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "306")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "306", "resp_code": "306000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "306", "resp_code": "306003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 306000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306010 | 记录不存在 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 306106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ 充值支付对账 ------------ 接口功能说明 ~~~~~~~~~~~~ 充值/支付对账 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==============+=================+===================+============+=======================================================================================+ | 版本号 | version | 定长 2 位 String | 必须 | 目前固定为 10 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 303 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长 4 位 String | 必须 | 每页记录数，>0 且 <=1000 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 交易类型 | trans\_type | 定长 8 位 String | 可选 | 02020100：充值 02020101：支付 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+mer_cust_id+begin_date+end_date+page_num+page_size+trans_type 返回参数列表 ~~~~~~~~~~~~ +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +========================+=====================+===================+============+=========================================================================================================================================================================================================================================================================================================================================================================================================+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 303 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长 6 位 String | 必须 | 303000--调用成功 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长 String | 必须 | 返回码的对应中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长 4 位 String | 必须 | 每页记录数，>0 且<=1000 的整数 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 记录总条数 | total\_num | 变长 String | 可选 | 记录总条数 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 对账结果串 | result\_list | 变长 String | 可选 | [{"order\_date":"20161129","order\_id":"201611292010001","platform\_seq\_id":"2016112910000085","out\_cust\_id":"6000010000000015","in\_cust\_id":"6000010000000025","trans\_type":"02020101","recharge\_type":"02020002","bank\_id":"01030000","trans\_amt":"12.23","real\_trans\_amt":"12.00","fee\_amt":"0.23","fee\_cust\_id":"6000010000000001","fee\_acct\_id":"888","trans\_stat":"02000002"}] | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单日期 | order\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单号 | order\_id | 变长 20 位 String | 必须 | 由商户生成，必须保证唯一，20 位内数字或字母的组合 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长 18 位 String | 必须 | 组成规则：8 位本平台日期 +10 位系统流水号 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 出账客户号 | out\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识，业务类型为充值时，出账客户是充值客户 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入账客户号 | in\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识，业务类型为充值时，入账客户是充值客户 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 业务类型 | trans\_type | 定长 8 位 String | 必须 | 02020100：充值； 02020101：支付 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 充值类型 | recharge\_type | 定长 8 位 String | 必须 | 02020000:个人网银充值； 02020001:企业网银充值； 02020002:快捷充值； 02020003:代扣充值 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 充值银行代号 | bank\_id | 变长 8 位 String | 必须 | 8 位银行代号 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 支付金额 | trans\_amt | 变长 14 位 String | 必须 | 交易金额，格式为###.00 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费金额 | fee\_amt | 变长 14 位 String | 可选 | 手续费金额，格式为###.00 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费扣款客户号 | fee\_cust\_id | 定长 16 位 String | 可选 | 手续费扣款客户号 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费扣款账户号 | fee\_acct\_id | 变长 9 位 String | 可选 | 手续费扣款账户号 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易状态 | trans\_stat | 定长 8 位 String | 必须 | 02000001：已受理； 02000002：成功；02000003：失败； 02000005：处理中 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +------------------------+---------------------+-------------------+------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+mer_cust_id+begin_date+end_date+page_num+page_size+total_num 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "303")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "303", "resp_code": "303000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "303", "resp_code": "303003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 303000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303010 | 记录不存在 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 303106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ 取现对账 -------- 接口功能说明 ~~~~~~~~~~~~ 取现对账 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==============+=================+===================+============+=======================================================================================+ | 版本号 | version | 定长 2 位 String | 必须 | 目前固定为 10 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 304 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长4 位 String | 必须 | 每页记录数，>0 且 <=1000 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 取现类型 | cash\_type | 定长 8 位 String | 可选 | 02030000：T0 ； 02030010：T1 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+mer_cust_id+begin_date+end_date+page_num+page_size+cash_type 返回参数列表 ~~~~~~~~~~~~ +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +========================+=======================+===================+============+============================================================================================================================================================================================================================================================================================================================================================================================================+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 304 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长 6 位 String | 必须 | 304000--调用成功 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长 String | 必须 | 返回码的对应中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长 4 位 String | 必须 | 每页记录数，>0 且<=1000 的整数 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 记录总条数 | total\_num | 变长 String | 可选 | 记录总条数 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 对账结果串 | result\_list | 变长 String | 可选 | [{"order\_date":"20161129","order\_id":"201611292010001","platform\_seq\_id":"2016112910000085","user\_cust\_id":"6000010000000015","cash\_type":"02020101","bank\_id":"01030000","card\_no":"62626468151546551","trans\_amt":"12.23","real\_trans\_amt":"12.00","in\_cust\_id":"6000010000000015","fee\_amt":"0.23","fee\_cust\_id":"6000010000000001","fee\_acct\_id":"888","trans\_stat":"02000002"}] | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单日期 | order\_date | 定长 8 位 String | 必须 | 格式为YYYYMMDD | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单号 | order\_id | 变长 20 位 String | 必须 | 由商户生成，必须保证唯一，20 位内数字或字母的组合 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长 18 位 String | 必须 | 组成规则：8 位本平台日期+10 位系统流水号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 取现客户号 | user\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 取现类型 | cash\_type | 定长 8 位 String | 必须 | 02030000：T0； 02030010：T1 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 银行代号 | bank\_id | 变长 8 位 String | 必须 | 8 位银行代号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 银行卡号 | card\_no | 变长 32 位 String | 必须 | 银行卡号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易金额 | trans\_amt | 变长 14 位 String | 必须 | 交易金额，格式为###.00 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 实际出账金额 | real\_trans\_amt | 变长 14 位 String | 可选 | 实际出账金额，交易成功时必须，格式为###.00 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费金额 | fee\_amt | 变长 14 位 String | 可选 | 手续费金额，格式为###.00 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费扣款客户号 | fee\_cust\_id | 定长 16 位 String | 可选 | 手续费扣款客户号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 手续费扣款账户号 | fee\_acct\_id | 变长 9 位 String | 可选 | 手续费扣款账户号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户收取服务费金额 | serv\_fee\_amt | 变长 14 位 String | 可选 | 商户收取用户的服务费金额，格式为###.00 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户子账户号 | serv\_fee\_acct\_id | 变长 9 位 String | 可选 | 服务费非空时为必填，商户用来收取服务费的子账户号 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易状态 | trans\_stat | 定长 8 位 String | 必须 | 02000001：已受理； 02000002：成功； 02000003：失败 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +------------------------+-----------------------+-------------------+------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+mer_cust_id+begin_date+end_date+page_num+page_size+total_num 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "304")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "304", "resp_code": "304000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "304", "resp_code": "304003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 304000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304010 | 记录不存在 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 304106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ 转账对账 -------- 接口功能说明 ~~~~~~~~~~~~ 前台快捷绑卡 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +==============+=================+===================+============+=======================================================================================+ | 版本号 | version | 定长 2 位 String | 必须 | 目前固定为 10 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 305 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长 4 位 String | 必须 | 每页记录数，>0 且 <=1000 的整数 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +--------------+-----------------+-------------------+------------+---------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+mer_cust_id+begin_date+end_date+page_num+page_size 返回参数列表 ~~~~~~~~~~~~ +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 中文名 | 参数名 | 数据格式 | 是否必须 | 说明 | +========================+=====================+===================+============+===================================================================================================================================================================================================================================================================+ | 消息类型 | cmd\_id | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 305 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回码 | resp\_code | 定长 6 位 String | 必须 | 305000--调用成功 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 应答返回描述 | resp\_desc | 变长 String | 必须 | 返回码的对应中文描述，中文为 UTF-8 字符集 URLEncode 编码后的字符串，商户应解码获取原文 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户客户号 | mer\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 开始日期 | begin\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 结束日期 | end\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD，开始日期和结束日期跨度不能大于 90 天 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 当前页号 | page\_num | 变长 String | 必须 | 查询数据的所在页号，>0 的整数 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 每页记录数 | page\_size | 变长4 位 String | 必须 | 每页记录数，>0 且<=1000 的整数 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 记录总条数 | total\_num | 变长 String | 可选 | 记录总条数 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 对账结果串 | result\_list | 变长 String | 可选 | [{"order\_date":"20161129","order\_id":"201611292010001","platform\_seq\_id":"2016112910000085","out\_cust\_id":"6000010000000015","out\_acct\_id":"777","in\_cust\_id":"6000010000000025","in\_acct\_id":"888","trans\_amt":"12.23","trans\_stat":"02000002"}] | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单日期 | order\_date | 定长 8 位 String | 必须 | 格式为 YYYYMMDD | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 商户订单号 | order\_id | 变长 20 位 String | 必须 | 由商户生成，必须保证唯一，20 位内数字或字母的组合 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 本平台交易唯一标识号 | platform\_seq\_id | 定长 18 位 String | 必须 | 组成规则：8 位本平台日期+10 位系统流水号 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 出账客户号 | out\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识，充值交易时，出账客户就是充值客户 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 出账账户号 | out\_acct\_id | 变长 9 位 String | 必须 | 出账账户号 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入款客户号 | in\_cust\_id | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 入账账户号 | in\_acct\_id | 变长 9 位 String | 必须 | 入账账户号 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易金额 | trans\_amt | 变长 14 位 String | 必须 | 交易金额，格式为###.00 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 交易状态 | trans\_stat | 定长 8 位 String | 必须 | 02000002：成功； 02000003：失败 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | 签名 | check\_value | 变长 256 位 String| 必须 | 加签规则：MD5+RSA 将参数列表的值按从上到下的顺序进行字符串拼接，调用签名函数获得的值 | +------------------------+---------------------+-------------------+------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+mer_cust_id+begin_date+end_date+page_num+page_size+total_num 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "305")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "305", "resp_code": "305000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "305", "resp_code": "305003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 305000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305010 | 记录不存在 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 305106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ 签约号查询接口 -------------- 接口功能说明 ~~~~~~~~~~~~ 提供查询此银行卡是否已经签约完成 调用方式：后台调用 应答方式：同步后台应答 接口类型：同步 请求参数列表 ~~~~~~~~~~~~ +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | 字段名 | 参数中文名称 | 数据格式 | 是否必须 | 说明 | +==================+================+=====================+============+==========================================================+ | version | 版本号 | 定长 2 位 String | 必须 | 目前固定为 10 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | cmd\_id | 消息类型 | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 315 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | mer\_cust\_id | 商户号 | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | user\_cust\_id | 用户号 | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | card\_no | 银行卡号 | 变长 20 位的 String | 必须 | | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | card\_mobile | 手机号 | 定长 11 位 String | 必须 | | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | cert\_id | 身份证号 | 变长 18 位的 String | 必须 | | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | mer\_priv | 商户私有域 | 变长 120 位的 String| 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ | extension | 扩展域 | 变长 512 位的 String| 可选 | 用于扩展请求参数 | +------------------+----------------+---------------------+------------+----------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java version+cmd_id+mer_cust_id+user_cust_id+card_no+card_mobile+mer_priv+extension 返回参数列表 ~~~~~~~~~~~~ +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | 参数中文名称 | 参数中文名称 | 数据格式 | 是否必须 | 说明 | +==================+================+=====================+============+===========================================================================================================+ | cmd\_id | 消息类型 | 定长 3 位 String | 必须 | 每一种消息类型代表一种交易，此处为 315 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | resp\_code | 应答返回码 | 定长 6 位的 String | 必须 | 305000--调用成功 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | resp\_desc | 应答描述 | 变长 String | 必须 | | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | mer\_cust\_id | 商户号 | 定长 16 位 String | 必须 | 由汇付生成，商户的唯一性标识 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | user\_cust\_id | 用户号 | 定长 16 位 String | 必须 | 由汇付生成，用户的唯一性标识 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | mer\_priv | 商户私有域 | 变长 120 位的 String| 可选 | 为商户的自定义字段，该字段在交易完成后由本平台原样返回 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ | extension | 扩展域 | 变长 512 位的 String| 可选 | 用于扩展请求参数 | +------------------+----------------+---------------------+------------+-----------------------------------------------------------------------------------------------------------+ 本接口加签拼接顺序： .. code:: java cmd_id+resp_code+resp_desc+mer_cust_id+user_cust_id+mer_priv+extension 代码示例 ~~~~~~~~ java .. code:: java String result = new String(); HttpClient client = new DefaultHttpClient(); HttpPost post = new HttpPost("https://finance.chinapnr.com/asharp/merchantRequest"); try { List nvps = new ArrayList(); nvps.add(new BasicNameValuePair("version", "10")); nvps.add(new BasicNameValuePair("cmd_id", "315")); nvps.add(new BasicNameValuePair("mer_cust_id", "6666000000000001")); nvps.add(new BasicNameValuePair("order_date", "20180327")); nvps.add(new BasicNameValuePair("order_id", "10000000001")); ....... post.setEntity(new UrlEncodedFormEntity(nvps)); HttpResponse httpResponse = client.execute(post); int code = httpResponse.getStatusLine().getStatusCode(); String returnStr = EntityUtils.toString(httpResponse.getEntity()); } catch (Exception e) { e.printStackTrace(); } 成功响应 .. code:: json 200 { "cmd_id": "315", "resp_code": "315000", "resp_desc": "交易成功", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 失败响应 .. code:: json 200 { "cmd_id": "315", "resp_code": "315003", "resp_desc": "交易失败", "mer_cust_id" : "6666000000000001", "order_date": "20180327", "order_id": "10000000001", ....... } 接口返回码 ~~~~~~~~~~ +------------------------------+----------------------------------------------------------------------------------------------+ | **返回参数** | **返回描述** | +------------------------------+----------------------------------------------------------------------------------------------+ | 315000 | 交易成功 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315099 | 系统异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315100 | 请求参数非法 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315101 | 商户无此接口权限 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315102 | 验证签名失败 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315103 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315104 | 用户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315106 | 商户签名未配置 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315107 | 消息类型与签名内容不一致 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315108 | 商户状态异常 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315302 | 查无协议号，须重新签约 | +------------------------------+----------------------------------------------------------------------------------------------+ | 315003 | 交易失败 | +------------------------------+----------------------------------------------------------------------------------------------+