（1）与银联达成风控服务的相关合作，具体商务合作事宜可咨询：riskproduct@unionpay.com

（2）根据“API接口”，完成对接客户端的开发；

（3）通过测试地址，自助完成功能测试：

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

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

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

（4）通过本页面点击“业务申请”，并说明：

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

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

          -- 提交签约协议和测试报告

（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. OpenAPI使用教程请参考在线文档：

《OpenAPI使用指南—接入指南》；

2. OpenAPI安全调用过程请参考在线文档：

《OpenAPI使用指南—获取产品token》；

《OpenAPI使用指南—产品功能接口调用》；

3. OpenAPI接口调用报文签名样例请参考在线文档：

《OpenAPI使用指南—报文签名样例代码》；

4. OpenAPI测试工具使用说明请参考在线文档：

《OpenAPI使用指南—OpenAPI测试工具》。