当前位置: 产品API > 风控 > 银联反欺诈服务
产品介绍
  • 服务对象
    银联发卡风险监控服务(URM):发卡机构
    收单资金延迟结算案例获取服务 :收单机构
  • 产品详情

    【银联发卡风险监控服务(URM)】

           为发卡机构提供轻接入、快部署的监控引擎和专家规则模型,具备实时拦截和准实时预警功能。发卡机构只需配备业务人员负责可疑案例处理,无需额外的技术开发和模型研发。

           该服务支持两种接入方案:无需改造系统的WEB方式和基于标准API的系统对接服务,本页面主要介绍采用系统对接方式时的API接口和报文内容,具体包括三个接口:

    ●    获取token接口,描述token的获取方法,token是银联开放平台中产品的全局唯一接口调用凭据;

    ●    URM可疑案例获取接口,描述查询URM可疑案例数据的方法;

    ●    URM调查结果回传接口,描述将调查结果回传至URM的方法。

           本服务的业务流程如下图所示:

    1.png

           本服务能覆盖主要的欺诈场景,并通过不同的手段给予控制。

    2.png


    【收单资金延迟结算案例获取服务】

           为防范不良商户与欺诈分子合谋欺诈风险,保障持卡人及成员机构的合法权益,中国银联联合成员机构建立了银联卡疑似欺诈合谋商户资金延迟结算机制,具体内容参考《银联卡疑似欺诈合谋商户资金延迟结算工作指引(试行)》(银联风管委〔2014〕4号)。

           对于收单机构,支持两种方式获取发卡机构提交的资金延迟结算案例:无需改造系统的WEB方式和基于标准API的系统对接服务,主要采用系统对接方式时的API接口和报文内容,具体包括两个接口:

    ●    获取token接口,描述token的获取方法,token是银联开放平台中产品的全局唯一接口调用凭据;

    ●    收单机构延迟结算案例获取接口,描述收单机构查询延迟结算待办任务的方法。

          本服务的业务流程如下图所示:

     3.png

  • 产品亮点

    中国银联在不断提升银联网络风险防控水平的同时,也在积极运用大数据技术和科技能力对外输出赋能。

应答码参照
应答码状态列表
  • 应答码 描述 解决方案
    0000 处理成功。 暂无
    6001 您的机构代码(XXXXXXXX)无权限查询或更新发卡业务管理机构(XXXXXXXX)的可疑交易案例。 暂无
    6002 您的可疑交易案例查询时间区间过长或频次过高,请参考API接口说明。 暂无
    6003 案例调查结果更新失败。 暂无
    6004 请求报文格式非法,请参考API接口说明。 暂无
    6005 查询失败。 暂无
    9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(https://open.unionpay.com/tjweb/user/info)进行白名单登记。 暂无
    9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。 暂无
    9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。 暂无
    9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置。 暂无
    9905 请求参数值有误,请确认请求参数信息。 暂无
    9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。 暂无
    9907 app_id与app_secret验证失败。 暂无
    9908 您的Token已过期,请重新获取Token。 暂无
    9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。 暂无
    9910 您的签名密钥未设置,请登录银联开放平台(https://open.unionpay.com/tjweb/user/info)确认相关配置。 暂无
    9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。 暂无
    9912 您的报文格式有误,要求报文符合JSON数据格式。 暂无
    9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求。 暂无
    9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。 暂无
    9915 您的API调用额度已耗尽,需充值付费后补充调用额度。 暂无
    9916 您的API并发调用额度已耗尽,需联系管理员调整您的并发限额。 暂无
    9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。 暂无
    9991 银联开放平台系统内部错误:产品服务调用失败。 暂无
    9992 银联开放平台系统内部错误:产品服务系统未知错误。 暂无
    9993 银联开放平台系统内部错误:产品服务未注册至服务中心。 暂无
    9994 银联开放平台系统内部错误:产品服务参数错误。 暂无
接入流程
接入流程

(1)与银联达成风控服务的相关合作,具体商务合作事宜可咨询:riskproduct@unionpay.com

(2)根据“API接口”,完成对接客户端的开发;

(3)通过测试地址,自助完成功能测试:

          -- 测试地址:https://openapi.unionpay.com/upapi/antiFraudTest/

          -- 测试机构代码:固定填写00010001

          -- 可开通沙箱调用功能,用于比对测试结果、自助排查错误、确认功能完整性;

(4)通过本页面点击“业务申请”,并说明:

          -- 机构名称、申请人姓名、部门、职位、联系手机、邮箱地址

          -- 申请开通的接口内容(URM or 延迟结算)

          -- 提交测试报告至riskproduct@unionpay.com

(5)待银联审核通过后(审核周期最长不超过3个工作日),可进行业务对接:

          -- 生产地址:https://openapi.unionpay.com/upapi/antiFraudService/

          -- 机构代码:URM交付时,银联分配的管理机构代码;

          -- 如果需要通过专线对接,请联系业务接口人开通。

 

报文举例

1.报文举例-获取token:


请求URL:

https://openapi.unionpay.com/upapi/antiFraudService/token?app_id=[value]&app_secret=[value]


应答JSON报文体:

{
           “respCd”:“0000”
           “respMsg”:“成功”
           “token”:”fsddfssseessseee”,
           “expire_in”:7200
}


2.报文举例-可疑案例获取


请求URL:

https://openapi.unionpay.com/upapi/antiFraudService/suspectTransactionCase?token=[value]&sign=[value]&ts=[value]


请求报文参数:

{
        
        “service_tp”:“URM01”,
        
        “ins_id_cd”:“00010000”,
        
        “trans_src”:“1”,
        
        “begin_ts”:“ 2018-09-11 00:00:00”,
        
        “end_ts”:“2018-09-11 00:00:10”,
        
        “page_no”:0
        
}


应答JSON报文体:

{
  “respCd”:“0000”,
  “respMsg”: “”, 
  “data”:{
    “case_num”:“2”,
    “page_no”:0,
        “total_page_num”:1,
        “total_record_num”:2,
    “query_result”:“0000”,
    “case”:[
      {
           “ar_pri_acct_no”:“”,
                “tfr_dt_tm”:“”,
                “sys_tra_no”:“”,
        “acpt_ins_id_cd”:“”,
        “fwd_ins_id_cd”:“”,
        “tfr_in_in”:“”,
        “curr_trans_tm”:“”,
        “acq_ins_id_cd”:“”,
        “iss_ins_id_cd”:“”,
        “card_class”:“”,
        “card_attr”:“”,
        “retri_ref_no”:“”,
        “resp_cd”:“”,
        “trans_id”:“”,
        “googs_tp”:“”,
        “trans_chnl”:“”,
        “trans_at”:“”,
        “trans_curr_cd”:“”,
        “loc_trans_tm”:“”,
        “loc_trans_dt”:“”,
        “mchnt_tp”:“”,
        “pos_entry_md_cd”:“”,
        “term_id”:“”,
        “mchnt_cd”:“”,
        “mchnt_nm”:“”,
        “trans_region”:“”,
        “trans_nation”:“”,
        “mobile”:“”,
        “client_ip”,
        “rule_id1”:“”,
        “rule_desc1”:“”,
        “rule_risk_lv1”:“”,
        “rule_id2”:“”,
        “rule_desc2”:“”,
        “rule_risk_lv2”:“”,
        “rule_id3”:“”,
        “rule_desc3”:“”,
        “rule_risk_lv3”:“”,
        “rule_id4”:“”,
        “rule_desc4”:“”,
        “rule_risk_lv4”:“”,
        “rule_id5”:“”,
        “rule_desc5”:“”,
        “rule_risk_lv5”:“”,
        “rule_prio_sum”:,
        “trans_src”:“”
        “line_id”:“”
        “event_id”:“”
        “fwd_sys_id”:“”
      },
      {
           “ar_pri_acct_no”:“”,    
                “tfr_dt_tm”:“”,
                “sys_tra_no”:“”,
        “acpt_ins_id_cd”:“”,
        “fwd_ins_id_cd”:“”,
        “tfr_in_in”:“”,
        “curr_trans_tm”:“”,
        “acq_ins_id_cd”:“”,
        “iss_ins_id_cd”:“”,
        “card_class”:“”,
        “card_attr”:“”,
        “retri_ref_no”:“”,
        “resp_cd”:“”,
        “trans_id”:“”,
        “googs_tp”:“”,
        “trans_chnl”:“”,
        “trans_at”:“”,
        “trans_curr_cd”:“”,
        “loc_trans_tm”:“”,
        “loc_trans_dt”:“”,
        “mchnt_tp”:“”,
        “pos_entry_md_cd”:“”,
        “term_id”:“”,
        “mchnt_cd”:“”,
        “mchnt_nm”:“”,
        “trans_region”:“”,
        “trans_nation”:“”,
        “mobile”:“”,
        “client_ip”,
        “rule_id1”:“”,
        “rule_desc1”:“”,
        “rule_risk_lv1”:“”,
        “rule_id2”:“”,
        “rule_desc2”:“”,
        “rule_risk_lv2”:“”,
        “rule_id3”:“”,
        “rule_desc3”:“”,
        “rule_risk_lv3”:“”,
        “rule_id4”:“”,
        “rule_desc4”:“”,
        “rule_risk_lv4”:“”,
        “rule_id5”:“”,
        “rule_desc5”:“”,
        “rule_risk_lv5”:“”,
        “rule_prio_sum”:,
        “trans_src”:“”
        “line_id”:“”
        “event_id”:“”
        “fwd_sys_id”:“”
      }
    ]
  }
}


3.报文举例-调查结果回传


请求URL:

https://openapi.unionpay.com/upapi/antiFraudService/caseSubmit?token=[value]&sign=[value]&ts=[value]


请求报文参数:

{
    “service_tp”:“URM02”,
    “bus_mgm_ins_id_cd”:“00010000”,
    “ar_pri_acct_no”:“”,
    “tfr_dt_tm”:“”,
    “sys_tra_no”:“”,
    “acpt_ins_id_cd”:“”,
    “fwd_ins_id_cd” :“”,
    “tfr_in_in” :“”,
    “trans_src” :“”,
    “line_id” :“”,
    “event_id” :“”,
    “fwd_sys_id” :“”,
    “invgt_result”:0
}


应答JSON报文体:

{
“respCd”:“0000”,
“respMsg”: “”, 
“data”: 
  {
    “submit_result”: “0000”
  }
}


4.报文举例-资金延迟结算任务获取


请求URL:

https://openapi.unionpay.com/upapi/antiFraudService/acqInsDelaySettleTask?token=[value]&sign=[value]&ts=[value]

 

请求报文参数:

{
        “service_tp”:”FDS01”,
        “ins_id_cd”:”00010000”,
        “trans_begin_dt”:” 20180911”,
        “trans_end_dt”:”20180911”,
        “page_no”:0
}


应答JSON报文体:

{
   “respCd”:”0000”,
   “respMsg”: “处理成功”, 
   “data”:{
        “case_num”:”2”,
        “page_no”:0,
        “total_page_num”:1,
        “total_record_num”:2,
        “query_result”,“0000”,
        “case”:[
          {
            “ar_pri_acct_no”:“”,
            “trans_dt”:“”,
            “trans_tm”:“”,
            “trans_at”:“”, 
            “trans_id”:“”,
            “trans_chnl”:“”,
            “resp_cd”:“”,
            “mchnt_cd”:“”,
            “mchnt_nm”:“”,
            “mchnt_tp”:“”,
            “term_id”:“”,
            “iss_ins_id_cd”:“”,
            “acq_ins_id_cd”:“”,
            “trans_region”:“”,
            “trans_cntry”:“”,
            “card_attr”:“”,
            “pos_entry_md_cd”:“”,
            “sys_tra_no”:””,
            “delay_settle_req_ts”:“”,
            “mchnt_settle_md”:“”,
            “delay_settle_res”:“”,
            “delay_settle_req_res_ts”:“”,
            “req_file_submit_ts”:“”,
            “req_file_check_res”:“”,
            “req_file_check_comments”:“”,
            “delay_proc_res”:“”,
            “delay_proc_file_submit_ts”:“”,
            “delay_proc_file_check_res”:“”,
            “delay_proc_file_check_comments”:“”,
            “evi_file_submit_ts”:“”,
            “evi_file_check_res”:“”
            “evi_file_check_comments”:“”,
            “fund_return_neg_res_submit_ts”:“”,
            “fund_return_neg_res”:“”,
            “fund_return_neg_res_comments”:“”,
            “fund_return_file_submit_ts”:“”,
            “fund_return_file_check_res”:“”,
            “fund_return_file_check_comments”:“”,
            “delay_release_file_submit_ts”:“”,
            “delay_release_file_check_res”:“”,
            “delay_release_file_check_comments”:“”,
            “task_tp”:“”
                    },
                   {
                    “ar_pri_acct_no”:“”,
                    “trans_dt”:“”,
                    “trans_tm”:“”,
                    “trans_at”:“”, 
                    “trans_id”:“”,
                    “trans_chnl”:“”,
                    “resp_cd”:“”,
                    “mchnt_cd”:“”,
                    “mchnt_nm”:“”,
                    “mchnt_tp”:“”,
                    “term_id”:“”,
                    “iss_ins_id_cd”:“”, 
                    “acq_ins_id_cd”:“”,
                    “trans_region”:“”,
                    “trans_cntry”:“”,
                    “card_attr”:“”,
                    “pos_entry_md_cd”:“”,
                    “sys_tra_no”:“”,
                    “delay_settle_req_ts”:“”,
                    “mchnt_settle_md”:“”,
                    “delay_settle_res”:“”,
                    “delay_settle_req_res_ts”:“”,
                    “req_file_submit_ts”:“”,
                    “req_file_check_res”:“”,
                    “req_file_check_comments”:“”,
                    “delay_proc_res”:“”,
                    “delay_proc_file_submit_ts”:“”,
                    “delay_proc_file_check_res”:“”,
                    “delay_proc_file_check_comments”:“”,
                    “evi_file_submit_ts”:“”,
                    “evi_file_check_res”:“”
                    “evi_file_check_comments”:“”,
                    “fund_return_neg_res_submit_ts”:“”,
                    “fund_return_neg_res”:“”,
                    “fund_return_neg_res_comments”:“”,
                    “fund_return_file_submit_ts”:“”,
                    “fund_return_file_check_res”:“”,
                    “fund_return_file_check_comments”:“”,
                    “delay_release_file_submit_ts”:“”,
                    “delay_release_file_check_res”:“”,
                    “delay_release_file_check_comments”:“”,
                    “task_stat”:“”
          }
        ]
      }
}
技术指南

1. “快速接入”产品API使用教程请参考在线文档:

《“快速接入”产品API指南—接入指南》


2. “快速接入”产品API安全调用过程请参考在线文档:

《“快速接入”产品API指南—获取产品token》

《“快速接入”产品API指南—产品功能接口调用》


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

《“快速接入”产品API指南—报文签名样例代码》


4. “快速接入”产品API测试工具使用说明请参考在线文档:

《“快速接入”产品API指南—“快速接入”测试工具》


API接口
获取token
接口描述
产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。
请求方式
GET
生产地址
https://openapi.unionpay.com/upapi/antiFraudService/token
测试地址
https://openapi.unionpay.com/upapi/antiFraudTest/token
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录技术开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string M-必填
响应信息 respMsg string M-必填
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in long M-必填 凭证有效时间,单位:秒
URM可疑案例获取
接口描述
发卡机构可通过该接口查询URM系统侦测出的可疑交易案例,返回可疑交易明细数据。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/antiFraudService/suspectTransactionCase
测试地址
https://openapi.unionpay.com/upapi/antiFraudTest/suspectTransactionCase
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位毫秒,对于Java一般使用System.currentTimeMillis();获取
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
服务类型 service_tp string 8 M-必填 URM01
管理机构代码 ins_id_cd string 11 M-必填 按照URM开通时,银联分配的管理机构代码填写
交易来源 trans_src string 1 M-必填 0:实时拦截 1:准实时预警
读取案例起始时间 begin_ts string 19 M-必填 示例: 2018-09-11 00:00:00 获取从该时间开始的产生的可疑案例,包含该时间点。
读取案例结束时间 end_ts string 19 M-必填 示例: 2018-09-11 00:00:10 获取截至该时间产生的可疑案例,不包含该时间点。
页码 page_no int M-必填 首次查询填0。 如果应答报文中的page_no+1< total_page_num,则说明查询结果超过10条,需要翻页;应将应答报文中的page_no+1进行翻页查询。
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 0 M-必填
应答消息 respMsg string 0 M-必填 返回消息详情。
应答报文 data map 0 M-必填
案例个数 case_num int 0 M-必填 本次查询应答报文中可疑案例的条数,最大为10条
页码 page_no int 0 M-必填 返回当前读取的页码,从0开始编号。与请求报文中的page_no相同。
总页数 total_page_num int 0 M-必填 请求报文时间区间内案例的总页数。
总记录数 total_record_num int 0 M-必填 请求报文时间区间内可疑案例的总条数。
查询结果 query_result string 4 M-必填 0000-成功
案例明细数组: case array 0 M-必填
卡号 ar_pri_acct_no string 19 M-必填
传输日期和时间 tfr_dt_tm string 10 C-依条件必填 mmddhhmmss;报文时间。条件:trans_src=1
系统跟踪号 sys_tra_no string 6 C-依条件必填 条件:trans_src=1
受理机构代码 acpt_ins_id_cd string 11 C-依条件必填 条件:trans_src=1
发送机构代码 fwd_ins_id_cd string 11 C-依条件必填 条件:trans_src=1
是否转入交易 tfr_in_in string 1 C-依条件必填 条件:trans_src=1
交易时间 curr_trans_tm string 14 M-必填 yyyymmddhhmmss;银联转接时间
收单机构代码 acq_ins_id_cd string 11 C-依条件必填 条件:trans_src=0
发卡机构代码 iss_ins_id_cd string 11 M-必填
卡种 card_class string 2 O-选填 01:人民币卡;02:人民币境外卡;03:双币种卡;04:国际卡;05:境外卡;06:外资卡;07:外卡
卡属性 card_attr string 2 O-选填 01:借记卡;02:贷记卡;03:准贷记卡
检索参考号 retri_ref_no string 12 O-选填
应答码 resp_cd string 2 O-选填
交易代码 trans_id string 3 O-选填
产品类型 goods_tp string 4 C-依条件必填 条件:trans_src=0
交易渠道 trans_chnl string 2 O-选填
交易金额 trans_at string 12 O-选填 单位为分
交易货币代码 trans_curr_cd string 3 O-选填
本地交易时间 loc_trans_tm string 6 O-选填
本地交易日期 loc_trans_dt string 4 O-选填
商户类型 mchnt_tp string 4 O-选填
服务点输入方式 pos_entry_md_cd string 3 O-选填
受卡机终端标识码 term_id string 8 O-选填
商户代码 mchnt_cd string 15 O-选填
商户名称 mchnt_nm string 40 O-选填
交易地区 trans_region string 4 O-选填
交易国家 trans_nation string 3 O-选填
手机号 mobile string 64 O-选填
IP地址 client_ip string 64 O-选填
触犯规则ID 1 rule_id1 string 16 M-必填
触犯规则描述 1 rule_desc1 string 100 M-必填
触犯规则风险等级 1 rule_risk_lv1 string 2 C-依条件必填 1:提示;2:关注;3:警告。条件:trans_src=1
触犯规则ID 2 rule_id2 string 16 O-选填
触犯规则描述 2 rule_desc2 string 100 O-选填
触犯规则风险等级 2 rule_risk_lv2 string 2 O-选填
触犯规则ID 3 rule_id3 string 16 O-选填
触犯规则描述 3 rule_desc3 string 100 O-选填
触犯规则风险等级 3 rule_risk_lv3 string 2 O-选填
触犯规则ID 4 rule_id4 string 16 O-选填
触犯规则描述 4 rule_desc4 string 100 O-选填
触犯规则风险等级 4 rule_risk_lv4 string 2 O-选填
触犯规则ID 5 rule_id5 string 16 O-选填
触犯规则描述 5 rule_desc5 string 100 O-选填
触犯规则风险等级 5 rule_risk_lv5 string 2 O-选填
优先级总和 rule_prio_sum int 0 M-必填
交易来源 trans_src string 1 M-必填 0:实时拦截;1:准实时预警
线路ID line_id string 2 C-依条件必填 条件:trans_src=1
事件ID event_id string 40 C-依条件必填 条件:trans_src=0
发送系统标识 fwd_sys_id string 2 C-依条件必填 条件:trans_src=0
URM调查结果回传
接口描述
发卡机构将可疑案例的调查结果回传至URM。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/antiFraudService/caseSubmit
测试地址
https://openapi.unionpay.com/upapi/antiFraudTest/caseSubmit
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
服务类型 service_tp string 8 M-必填 URM02
管理机构代码 ins_id_cd string 11 M-必填 按照URM开通时,银联分配的管理机构代码填写
卡号 ar_pri_acct_no string 19 M-必填 与案例获取接口中应答报文对应参数取值相同。
传输日期和时间 tfr_dt_tm string 10 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
系统跟踪号 sys_tra_no string 6 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
受理机构代码 acpt_ins_id_cd string 11 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
发送机构代码 fwd_ins_id_cd string 11 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
是否转入交易 tfr_in_in string 1 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
交易来源 trans_src string 1 M-必填 与案例获取接口中应答报文对应参数取值相同。
线路ID line_id string 2 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=1
事件ID event_id string 40 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=0
发送系统标识 fwd_sys_id string 2 C-依条件必填 与案例获取接口中应答报文对应参数取值相同。条件:trans_src=0
机构回传结果 invgt_result int M-必填 0确认欺诈;1 持卡人确认交易;2 未确认;3 丢弃;4 持卡人否认交易;5疑似电信诈骗
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string M-必填
应答消息 respMsg string M-必填 返回消息详情。
应答报文 data map M-必填
案例提交结果 submit_result string 4 M-必填 0000-成功,其他值失败。
资金延迟结算任务获取
接口描述
收单机构可通过该接口查询风险服务收单机构资金延迟结算待办任务,返回收单机构资金延迟结算待办任务明细。
请求方式
POST
生产地址
https://openapi.unionpay.com/upapi/antiFraudService/acqInsDelaySettleTask
测试地址
https://openapi.unionpay.com/upapi/antiFraudTest/acqInsDelaySettleTask
请求URL参数
名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
服务类型 service_tp string 5 M-必填 风险服务简称(3位)+服务编码(2位),默认填写FDS01
机构代码 ins_id_cd string 11 M-必填 按照资金延迟结算业务开通时,银联分配的机构代码填写
交易起始日期 trans_begin_dt string 8 O-选填 YYYYMMDD
交易结束日期 trans_end_dt string 8 O-选填 YYYYMMDD
页码 page_no int M-必填 用于应对查询结果超过10条,需要翻页的情况。首次查询填0,应答报文中会返回总页数,当前页码+ 1 <总页数,需要将page_no+1进行翻页查询。
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 0 M-必填
应答消息 respMsg string 0 M-必填 返回消息详情。
应答报文 data map 0 M-必填
案例个数 case_num int M-必填 本次查询应答报文中可疑案例的条数,最大为10条
页码 page_no int M-必填 返回当前读取的页码,从0开始编号。
总页数 total_page_num int M-必填 页数
总记录数 total_record_num int M-必填 记录数
查询结果 query_result string 4 M-必填 0000-成功
案例明细数组: case array M-必填
卡号 ar_pri_acct_no string 19 M-必填
交易日期 trans_dt string 8 O-选填 YYYYMMDD
交易时间 trans_tm string 6 O-选填 HHmmSS
交易金额 trans_at string 12 O-选填 单位为分
交易类型 trans_id string 3 O-选填
交易渠道 trans_chnl string 4 O-选填
应答码 resp_cd string 2 O-选填
商户代码 mchnt_cd string 15 O-选填
商户名称 mchnt_nm string 40 O-选填
商户类型 mchnt_tp string 4 O-选填
终端编号 term_id string 8 O-选填
发卡机构代码 iss_ins_id_cd string 11 O-选填
收单机构代码 acq_ins_id_cd string 11 O-选填
交易地区 trans_region string 4 O-选填
交易国家 trans_cntry string 3 O-选填
卡属性 card_attr string 2 O-选填 01:借记卡 02:贷记卡 03:准贷记卡
服务点输入方式 pos_entry_md_cd string 3 O-选填
系统跟踪号 sys_tra_no string 6 O-选填
延迟结算申请时间 delay_settle_req_ts string 14 O-选填 YYYYMMDDHHmmSS
商户结算模式 mchnt_settle_md string 1 O-选填
延迟结算预申请结果 delay_settle_res string 1 O-选填
延迟结算预申请结果反馈时间 delay_settle_req_res_ts string 14 O-选填 YYYYMMDDHHmmSS
申请函提交时间 req_file_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
申请函审核结果 req_file_check_res string 1 O-选填
申请函审核备注 req_file_check_comments string 200 O-选填
延迟结算处理结果 delay_proc_res string 1 O-选填
延迟处理函提交时间 delay_proc_file_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
延迟处理函审核结果 delay_proc_file_check_res string 1 O-选填
延迟处理函审核备注 delay_proc_file_check_comments string 200 O-选填
证明材料提交时间 evi_file_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
证明材料审核结果 evi_file_check_res string 1 O-选填
证明材料审核备注 evi_file_check_comments string 200 O-选填
资金回退协商结果提交时间 fund_return_neg_res_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
资金回退协商结果 fund_return_neg_res string 1 O-选填
资金回退协商结果备注 fund_return_neg_res_comments string 200 O-选填
资金回退意见函提交时间 fund_return_file_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
资金回退意见函审核结果 fund_return_file_check_res string 1 O-选填
资金回退意见函审核备注 fund_return_file_check_comments string 200 O-选填
延迟解除通知提交时间 delay_release_file_submit_ts string 14 O-选填 YYYYMMDDHHmmSS
延迟解除通知审核结果 delay_release_file_check_res string 1 O-选填
延迟解除通知审核备注 delay_release_file_check_comments string 200 O-选填
延迟结算待办任务类型 task_stat string 2 O-选填
联系我们

业务咨询: 章明

021-20631064

zhangming@unionpay.com

技术咨询: 李赛阳

021-20633246

lisaiyang@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号