ARM可疑案例获取
接口描述
该接口主要实现根据请求的受理机构代码,将指定时间段内的ARM可疑案例返回给请求方,考虑到数据量可能较大,会采用分页获取的方式。
请求方式
POST
生产调用地址
https://openapi.unionpay.com/upapi/antiFraudService/arm/susTransCase/v1
测试调用地址
https://openapi.unionpay.com/upapi/antiFraudTest/arm/susTransCase/v1
URL请求参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
产品token |
token |
string |
|
|
M-必填
|
详情请参考“获取token”接口中应答参数“token”的具体数据。 |
|
签名信息 |
sign |
string |
|
|
M-必填
|
详细签名算法可参考“技术指南”板块第3条。 |
|
时间戳 |
ts |
long |
|
|
M-必填
|
单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。 |
HTTP报文体参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
受理机构代码 |
acptInsIdCd |
string |
8 |
|
M-必填
|
银联统一分配的机构代码
该参数已配置预检规则: 业务产品关联代码校验规则
|
|
案例起始时间 |
transBeginTm |
string |
14 |
|
M-必填
|
时间格式为:YYYYMMDDhhmmss包含该时间点
|
|
案例终止时间 |
transEndTm |
string |
14 |
|
M-必填
|
时间格式为:YYYYMMDDhhmmss不包含该时间点
|
|
页码 |
pageNum |
string |
4 |
|
M-必填
|
每轮首次查询时,应将“页码”字段填写为“0”,如果应答报文中“应答结果总页数”的数值大于1(N>1),则应将“页码”字段依次递增至N-1进行逐次查询,以完成所有数据的获取。
|
|
案例来源 |
sourceId |
string |
2 |
01 |
M-必填
|
“案例来源”字段为01(专家规则案例)返回交易列表,可从交易列表中提取可疑商户;“案例来源”字段为02或03或04(智能模型案例)直接返回商户列表
|
同步应答参数
|
中文名称 |
英文名称 |
域类型 |
域长度 |
默认值 |
请求要求 |
备注 |
|
应答码 |
respCd |
string |
4 |
|
M-必填
|
参考附录“应答码参照”
|
|
应答消息 |
respMsg |
string |
|
|
M-必填
|
如果respCd不是0000,该字段解释了具体的出错原因。
|
|
应答结果总页数 |
totalPages |
int |
|
|
O-选填
|
查询结果的总页数
|
|
应答数据 |
data |
map |
|
|
O-选填
|
成功时,返回查询时间段内的案例详情,即“可疑交易列表”,但该表单页内所含交易数的上限为100条,即如果“应答结果总页数”的数值大于1,则应通过翻页查询获取所有可疑交易数据。
|
示例代码