描述
本部分内容描述了平台与商家之间的单笔交易结果查询的批量接口, 商家可以通过此接口根据支付平台商户号来查询批量订单的详细信息。
支付接口参数定义
商户批量查询街口支付平台订单信息,调用API必须遵循以下参数规则:
参数 | 格式 | 必填 | 说明 |
---|---|---|---|
merchant_code | String(15) | | 商家号,商户签约时分配给商家的唯一身份标识。 |
interface_version | String(5) | | 接口版本,门店聚合商户固定值:V2.0(大写),清算聚合商户固定值:V1.0(大写)。注意 |
sign_type | String(3) | | 签名类型,固定值:MD5或RSA(大写) |
batch_order | String | | 批量查询订单号,多个订单号拼接成一串字符串,用双下划线(__)分割每个订单号,不参与签名。最多批量查询500个订单号。如: 订单号1__订单号2__订单号3__.... |
sign | String | |
MD5或RSA签名后字符串,不参与签名,查询订单接口签名要求说明请参考下面。 |
查询批量订单签名规则
商户批量查询街口支付平台订单,签名原始串必须遵循以下规则:
1、所有指定签名参数值按照(parmValue1+~|~+parmValue2+~|~+parmValue3+…)拼接而成,每个参数值中间采用分隔符 ~|~ 拼接。
2、签名原始串中,字段名和字段值都采用原始值,不进行URL Encode。
3、参数值区分大小写。
4、签名排列顺序必须按照指定格式排列拼接。见下文。
批量查询订单请求签名原始串
post 请求 批量查询订单原始签名串格式如下:
请求订单批量查询原始签名串街口支付
- merchant_code+"~|~"+interface_version+"~|~"+sign_type
商户算法签名模型设置为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);