接口描述
用户通过查询参数向平台查询符合条件的单笔交易记录。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/udia/servService/querySingleTn/v1
测试调用地址
https://openapi.unionpay.com/upapi/udiaTest/servTest/querySingleTn/v1
URL请求参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 产品token | token | string | M-必填 | 详情请参考“获取token”接口中应答参数“token”的具体数据。 | |||
| 签名信息 | sign | string | M-必填 | 详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。 | |||
| 时间戳 | ts | long | M-必填 | 单位毫秒，对于Java一般使用System.currentTimeMillis();获取。 |
HTTP报文体参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 版本号 | version | string | 8 | V1.0.0 | O-选填 |
|
|
| 交易类型 | action | string | 4 | M-必填 |
|
||
| 交易请求时间 | txnTime | string | 14 | M-必填 | 格式：yyyyMMddhhmmss。
|
||
| 交易来源 | txnSrc | string | 2 | M-必填 |
|
||
| 应用方代码 | orgCode | string | 8 | M-必填 | 用于标识落地实施方和内部数据使用方，编码规则：8位数字；若该应用方为银联入网成员机构，则复用已有的机构代码，若非银联成员机构，则与UDIA通过线下协商获得；通过“关联信息”进行校验。
该参数已配置预检规则： 业务产品关联代码校验规则 |
||
| 应用方请求流水号 | orgSeq | string | 30 | M-必填 | 用于唯一标识落地实施方和内部数据使用方的一笔交易请求，编码规则：8位应用方代码+14位时间+8位随机数。
|
||
| 待查询的应用方请求流水号 | queryOrgSeq | string | 30 | M-必填 | 填写待查询交易对应的应用方请求流水号。
|
||
| 待查询的平台流水号 | queryUDIASeq | string | 32 | O-选填 | 如果填写待查询交易对应的平台流水号将提升查询效率与成功率。
|
同步应答参数
| 中文名称 | 英文名称 | 域类型 | 域长度 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|---|
| 应答码 | respCd | string | 4 | M-必填 |
|
||
| 应答消息 | respMsg | string | 128 | M-必填 |
|
||
| 业务字段集合 | data | map | C-按条件必填 |
|
示例代码
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
