描述

    本部分内容描述了平台与商家之间的单笔代付申请结果查询接口， 商家可以通过此接口来查询单笔代付订单的详细信息。

 

支付接口参数定义

商户查询街口支付平台代付订单信息，调用API必须遵循以下参数规则：

参数	格式	必填	说明
merchant_code	String(15)	ဆ	商家号，商户签约时分配给商家的唯一身份标识。
interface_version	String(5)	ဆ	接口版本，固定值：V1.0(大写)
sign_type	String(3)	ဆ	签名类型，固定值：MD5或RSA(大写)
order_no	String(30)	ဆ	商家网站平台的代付订单号，由商户保证其唯一性，由字母、数字、下划线组成。
sign	String	ဆ	MD5或RSA签名后字符串，不参与签名，查询订单接口签名要求说明请参考下面。

查询代付订单签名规则

商户查询街口支付平台代付订单，签名原始串必须遵循以下规则：

1、所有指定签名参数值按照（parmValue1+~|~+parmValue2+~|~+parmValue3+…）拼接而成，每个参数值中间采用分隔符 ~|~ 拼接。

2、签名原始串中，字段名和字段值都采用原始值，不进行URL Encode。

3、参数值区分大小写。

4、签名排列顺序必须按照指定格式排列拼接。见下文。

查询代付订单请求签名原始串

post 请求 查询代付订单原始签名串格式如下:

请求代付订单查询原始签名串街口支付
merchant_code+"~|~"+interface_version+"~|~"+sign_type+"~|~"+order_no

商户算法签名模型设置为MD5时，采用下面签名算法样例。

MD5查询请求签名街口支付
sign = Md5(查询代付订单请求签名原始串+"~|~"key=商户MD5密钥)

商户算法签名模型设置为RSA时，采用下面签名算法样例。

请求查询RSA签名算法街口支付
Java：
sign = RSAWithSign.signByPrivateKey(请求代付订单查询原始签名串,商户生成的私钥)
 
PHP：
$privatekey = openssl_get_privatekey('商户生成的私钥');
openssl_sign(请求代付订单查询原始签名串,$sign_info,$privatekey,OPENSSL_ALGO_MD5);
$sign = base64_encode($sign_info);

---

代付查询接口响应返回参数描述

   数据将以Json字符串形式在同一会话中同步返回。

 

查询代付接口响应返回参数定义

查询接口不管成功与否必返回下面列表中前二个参数必须返回。其他参数错误情况返回null.

参数	格式	必填	说明
msgcode	String(20)		查询是否成功状态码，取值为“00000” 代表查询成功， 其他错误码代表查询失败。
msg	String(20)		查询状态错误中文描述（乱码情况可查看文档中错误码对照）
transfer_status	String(8)	ဆ	代付订单处理状态，固定值：success（成功）、failure（失败）、waiting（处理中）
transfer_desc	String(200)	ဆ	代付订单处理参考描述。
merchant_code	String(15)	ဆ	商家号，商户签约时分配给商家的唯一身份标识。
interface_version	String(5)	ဆ	接口版本，固定值：V1.0(大写)
transfer_no	String(30)	ဆ	街口支付平台代付订单号。
order_no	String(30)	ဆ	商家网站平台的代付订单号，由商户保证其唯一性，由字母、数字、下划线组成。
bankCode	String(10)	ဆ	代付银行名称,参数为本平台规定银行编码。编码列表请参考 银行编码。
provice	String(10)	ဆ	开户省份（例如：山东省）。
city	String(10)	ဆ	开户市（例如：济南市）。
district	String(10)	ဆ	开户区或县（例如：历城区或济阳县）。
branchName	String(50)	ဆ	支行名称, 仅填写支行信息 ,如:太平路支行， 仅需填写支行名称不需要银行名称。
accountName	String(50)	ဆ	银行卡开户名称或收款人姓名
cardNo	String(30)	ဆ	转账银行卡号
amount	Number	ဆ	代付转账金额，以元为单位，精确到小数点后两位.例如：12.01
consumption	Number	ဆ	代付转账手续费（元）
phone	String(11)	ဆ	代付银行卡绑定的手机号码
transferType	String(7)	ဆ	对公、对私转账类型，固定值: public (对公)、private (对私)
remark	String(50)	ဆ	商家代付转账备注