查询明细¶
接口描述¶
该接口用于三方app调用发起消费收款,支持银行卡、反扫、正扫聚合支付,通过传入不同支付通道、支付方式唤起不同支付界面。
接入方式¶
PnrTransListener listener = new PnrTransListener() {
@Override
public void onResult(String response) {
Timber.d("交易结果:" + response);
}
};
JsonObject jsonData = new JsonObject();
jsonData.addProperty(PnrRequestKey.KEY_INTERFACE_TYPE, InterfaceType.Data.IT_QUERY_ORDER);
PnrService.getInstance(mContext).getData(jsonData.toString(), listener);
请求参数¶
listener
为结果监听,不能为空;onResult(String response)
为结果回调,response
为json串,值参见 返回结果
jsonData
为json字符串。- 其内的字段说明如下:
字段名称 | 中文描述 | 数据类型 | 要求 | 说明 |
---|---|---|---|---|
interfaceType | 接口类型 | String | M | 接口类型,查询明细接口固定值为 InterfaceType.Data.IT_QUERY_ORDER (queryOrder) |
termOrdId | 终端订单号 | String | O | 需打印订单对应的终端订单号,对应原交易返回的termOrdId(termOrdId,outOrdId,partyOrdId和tradeNo四选一至少必填一个) |
outOrdId | 外部订单号 | String | O | 需打印订单对应的外部订单号,对应原交易返回的outOrdId(termOrdId,outOrdId,partyOrdId和tradeNo四选一至少必填一个)(扫码交易不支持此字段) |
partyOrderId | 商户单号 | String | O | 需打印订单对应的微信或支付宝商户单号,对应原交易返回的partyOrdId(termOrdId,outOrdId,partyOrdId和tradeNo四选一至少必填一个) |
tradeNo | 交易单号 | String | O | 需打印订单对应的微信或支付宝交易单号,对应原交易返回的tradeNo(termOrdId,outOrdId,partyOrdId和tradeNo四选一至少必填一个) |
isSale | 是否消费交易 | String | M | 固定值0或1(0:否,即反向交易;1或者其他:是,即正向交易) |
channelId | 支付渠道 | String | M | 固定值acquire或scan(acquire:银行卡;scan:扫码) |
返回结果¶
response
为json字符串。- 其内字段如下:
字段名称 | 中文描述 | 数据类型 | 要求 | 说明 |
---|---|---|---|---|
responseCode | 系统返回码 | String | M | 参见 系统返回码 |
message | 错误信息 | String | C | 当返回码为非00时出现 |
merOrdId | 订单号 | String | M | 原交易的outOrdId不为空时则返回传入的outOrdId;否则返回收银台自动生成的订单号(终端订单号termOrdId) |
当交易成功(responseCode=00)时,下面参数生效 | ||||
transDate | 交易日期 | String | M | 8位,yyyyMMdd |
transTime | 交易时间 | String | M | 6位,HHmmss |
channelId | 支付渠道 | String | M | 银行卡:acquire 扫一扫:scan 付款码:qrcode |
mobilePayType | 支付方式 | String | C | 扫一扫或付款码交易,此字段生效 (微信:W 支付宝:A 银联钱包:U) |
ordAmt | 交易金额 | String | M | 单位:分 |
ordId | 汇付交易流水号 | String | M | 汇付生成的后台唯一标识 |
batchId | 批次号 | String | O | 6位 |
voucherNo | 凭证号 | String | O | 6位 |
refNo | 参考号 | String | O | 12位 |
bankName | 银行名称 | String | O | 仅银行卡交易此字段生效 |
cardType | 借贷记标识 | String | O | 仅银行卡交易此字段生效,C-信用卡, D-借记卡 |
payCardId | 交易卡号 | String | O | 仅银行卡交易此字段生效,格式为前6后4显示中间带掩码 |
authNo | 授权号 | String | O | 仅银行卡交易此字段生效 |
memberId | 商户号 | String | M | 汇付商户号 |
merName | 商户名称 | String | O | 汇付商户名称 |
transStat | 交易状态 | String | O | 参见 交易状态码 |
refAmt | 已退金额 | String | O | 已退金额 |
tradeNo | 扫码交易单号 | String | O | 支付宝、微信交易号 |
outOrdId | 外部订单号 | String | C | outOrdId对应传入的outOrdId |
termOrdId | 终端订单号 | String | M | 终端收银台生成的订单号 |
partyOrderId | 商户单号 | String | O | 用于退款,指支付宝、微信商户单号 |
oriOutOrderId | 原外部订单号 | String | O | 原消费交易外部订单号 |
oriTermOrdId | 原终端订单号 | String | M | 原消费交易终端订单号 |