代收
查看产品
更新时间:2023-07-14
批量交易状态查询类交易接口
接口描述
用于商户到银联全渠道支付查询批量代收交易状态,并下载批量代收结果文件。
收到批量交易结果通知以后,商户应向银联全渠道支付平台发起批量交易状态查询类交易,查询批量交易结果。完成交易的过程不需要同持卡人交互,属于后台交易。批量交易状态查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。
一般建议间隔1小时后查询。处理成功的交易限制只能查5次,超过5次会报错,错误码37:已超过最大查询次数或操作过于频繁。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/batchTrans.do
测试调用地址
https://gateway.test.95516.com/gateway/api/batchTrans.do
请求参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
M-必填
|
默认取值:UTF-8
|
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填
|
填写对报文摘要的签名
|
|
产品类型 |
bizType |
N6 |
无 |
M-必填
|
|
|
接入类型 |
accessType |
N1 |
无 |
M-必填
|
0:商户直连接入 1:收单机构接入 2:平台商户接入
|
|
收单机构代码 |
acqInsCode |
AN8..11 |
无 |
C-按条件必填
|
接入类型为收单机构接入时需上送
|
|
商户代码 |
merId |
AN15 |
无 |
C-按条件必填
|
接入类型为商户接入时需上送
|
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
M-必填
|
原批量代收请求的交易时间
|
|
批次号 |
batchNo |
N4 |
无 |
M-必填
|
原交易批次号
|
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填
|
查看详情
|
|
渠道类型 |
channelType |
N2 |
无 |
M-必填
|
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填
|
非对称签名:
01(表示采用RSA签名)
HASH表示散列算法
11:支持散列方式验证SHA-256
12:支持散列方式验证SM3
|
|
交易类型 |
txnType |
N2 |
无 |
M-必填
|
取值: 22:批量查询
|
|
交易子类 |
txnSubType |
N2 |
无 |
M-必填
|
01:退货 03:代付 02:代收
|
|
请求方保留域 |
reqReserved |
ANS1..1024 |
无 |
O-选填
|
商户自定义保留域,交易应答时会原样返回
|
|
证书ID |
certId |
N1..128 |
无 |
M-必填
|
|
|
版本号 |
version |
NS5 |
无 |
M-必填
|
固定填写
|
|
控制规则 |
ctrlRule |
N32 |
无 |
O-选填
|
32位01字符串控制位, 从左至右第五位取值为1时表示不返signPubKeyCert字段
|
应答报文(同步应答)
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
R-需要返回 |
|
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填 |
|
|
产品类型 |
bizType |
N6 |
无 |
R-需要返回 |
|
|
接入类型 |
accessType |
N1 |
无 |
R-需要返回 |
0:商户直连接入 1:收单机构接入 2:平台商户接入
|
|
收单机构代码 |
acqInsCode |
AN8..11 |
无 |
C-按条件必填 |
接入类型为收单机构接入时需返回 |
|
商户代码 |
merId |
AN15 |
无 |
R-需要返回 |
|
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
M-必填 |
批量代收请求的交易时间 |
|
批次号 |
batchNo |
N4 |
无 |
R-需要返回 |
|
|
批量文件内容 |
fileContent |
ANS1..1000000 |
无 |
C-按条件必填 |
交易处理完成时返回 |
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填 |
查看详情 |
|
应答码 |
respCode |
AN2 |
无 |
M-必填 |
|
|
应答信息 |
respMsg |
ANS1..256 |
无 |
M-必填 |
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填 |
|
|
签名公钥证书 |
signPubKeyCert |
AN1..2048 |
无 |
C-按条件必填 |
此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
|
交易类型 |
txnType |
N2 |
无 |
R-需要返回 |
取值:同原交易类型 |
|
交易子类 |
txnSubType |
N2 |
无 |
R-需要返回 |
同原交易子类 |
|
请求方保留域 |
reqReserved |
ANS1..1024 |
无 |
R-需要返回 |
|
|
版本号 |
version |
NS5 |
无 |
R-需要返回 |
|
异常应答说明
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”; 交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常