银联风控·水晶球——可信数字身份认证服务 关注
身份认证
收单机构
商户
发卡机构
OpenAPI
银联基于公安部、国家移民局、出入境管理局、全国公民号码查询中心以及三大通信运营商等权威信源,面向合作机构提供安全、高效、可靠的个人身份认证及企业信息验证服务

1.报文举例-获取token:


请求URL:

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


应答JSON报文体:

{
  "respCd":"0000",
  "respMsg":"",
  "token":"fsddesesesasdsfs",
  "expire_in":7200
}


2.报文举例-身份认证


请求URL:

https://openapi.unionpay.com/upapi/udia/authService/identity/v1?token=[value]&sign=[value]&ts=[ts]


请求报文参数:

{
       "version": "2.0.0",
       "orgCode": "00010001",
       "action": "1001",
       "txnTime": "20200924163226",
       "orgSeq": "000000012020091410223100000001",
       "comUserId": "0001000100000001",
       "authCode": "DN0001",
       "sceneCode": "01",
       "protocolVersion": "2020090215322600000002",
       "authSeq": "2020092415322100000001",
       "name": "张三",
       "certType": "01",
       "txnSrc": "01",
       "certCode": "310111199901011232"
}


应答JSON报文体:

{
     "respCd":"0000",
     "respMsg":"处理成功",
     "data":
     {
         "authCode":"DN0001",
         "action":"1001",
         "respTime":"20200922181219605",
         "txnTime":"20200922153226",
         "authExt":"验证一致",
         "orgSeq":"000100012020092218121840276448",
         "authRes":"00",
         "udiaseq":"e314a9ce9bcf45c792ed7589778b7328"
     }
 }


3.报文举例-注册外部数据使用方

请求URL:

https://openapi.unionpay.com/upapi/udia/servService/regComUser/v1?token=[value]&sign=[value]&ts=[ts]


请求报文参数:

{
       "action": "1901",
       "txnTime": "20200914120000",
       "txnSrc": "01",
       "orgCode": "00010001",
       "orgSeq": "000100002020091412000012345681",
       "mesgType": "01",
       "comUserId": "0001000100000005",
       "comName": "XX股份有限公司",
       "comSname": "XX公司",
       "industryType": "0200",
       "adminName": "张三",
       "adminIdCode": "310111199901011234",
       "csPhone": "12312341234",
       "comType": "01",
       "comIdType": "01",
       "comIdCode": "1234567891",
       "legalName": "test",
       "legalIdCode": "0987654321",
       "sceneCode": "01|02|03|04|05",
       "comUserSite": "1000"
}


应答JSON报文体:

{
       "respCd": "0000",
       "respMsg": "注册外部数据使用方执行成功",
       "data": {
              "action": "1901",
              "txnTime": "20200914120000",
              "respTime": "20200925134113",
              "orgSeq": "000100002020091412000012345681",
              "UDIASeq": "ee88e6ba510f47ccbaf4c19a604a4ccc",
              "comName": "XX股份有限公司",
              "comSname": "XX公司",
              "comUserId": "0001000100000005"
       }
}



4.报文举例-查询已注册外部数据使用方


请求URL:

https://openapi.unionpay.com/upapi/udia/servService/queryComUser/v1?token=[value]&sign=[value]&ts=[ts]

 

请求报文参数:

{
    "action": "1902",
    "txnTime": "20200914120000",
    "txnSrc": "01",
    "orgCode": "00010001",
    "orgSeq": "000100002020091412000012345684",
    "pageNo": "1",
    "pageSize": "5"
}


应答JSON报文体:

{
    "respCd": "0000",
    "respMsg": "查询已注册外部数据使用方执行成功",
    "data": {
        "action": "1902",
        "txnTime": "20200914120000",
        "respTime": "20200925133455",
        "orgSeq": "000100002020091412000012345684",
        "UDIASeq": "8c5ab6fae7854967af82f580fe691d4a",
        "currentSize": 4,
        "totalPage": 1,
        "currentPage": 1,
        "comUsers": [{
            "comName": "XX股份有限公司1",
            "comSname": "XX公司1",
            "regTime": "2020-09-15 19:10:19"
        }, {
            "comName": "XX股份有限公司2",
            "comSname": "XX公司2",
            "regTime": "2020-09-15 18:40:59"
        }, {
            "comName": "XX股份有限公司3",
            "comSname": "XX公司3",
            "regTime": "2020-09-14 20:23:11"
        }, {
            "comName": "XX股份有限公司4",
            "comSname": "XX公司4",
            "regTime": "2020-09-14 15:18:59"
        }]
    }
}



5.报文举例-单笔查询交易记录


请求URL:

https://openapi.unionpay.com/upapi/udia/servService/querySingleTn/v1?token=[value]&sign=[value]&ts=[ts]

 

请求报文参数:

{
    "action": "1101",
    "txnTime": "20200914120000",
    "txnSrc": "01",
    "orgCode": "00010001",
    "orgSeq": "000100012020091412000012345682",
    "queryOrgSeq": "000100012020092509543518448488",
    "queryUDIASeq": "b34ea8b25d5f46ea9839e138d449cf0b"
}


应答JSON报文体:

{
    "respCd": "0000",
    "respMsg": "单笔查询认证交易记录执行成功",
    "data": {
        "action": "1101",
        "txnTime": "20200914120000",
        "respTime": "20200925133659",
        "orgSeq": "000100012020091412000012345682",
        "UDIASeq": "75d25825f01c41d79519195ee040238f",
        "comUserId": "0001000100000001",
        "origOrgSeq": "000100012020092509543518448488",
        "origUDIASeq": "b34ea8b25d5f46ea9839e138d449cf0b",
        "authCode": "DN0001",
        "origAuthRes": "00",
        "origAuthExt": "验证一致"
    }
}



6.报文举例-批量查询交易记录


请求URL:

https://openapi.unionpay.com/upapi/udia/servService/queryBatchTn/v1?token=[value]&sign=[value]&ts=[ts]

 

请求报文参数:

{
    "action": "1102",
    "txnTime": "20200914120000",
    "txnSrc": "01",
    "orgCode": "00010001",
    "orgSeq": "000100012020091412000012345678",
    "queryComUserId": "0001000100000001",
    "queryAuthCode": "DN0001",
    "queryBeginTime": "20200914183026",
    "queryEndTime": "20200914184026",
    "pageNo": "1",
    "pageSize": "10"
}


应答JSON报文体:

{
       "respCd": "0000",
       "respMsg": "批量查询认证交易记录执行成功",
       "data": {
              "action": "1102",
              "txnTime": "20200914120000",
              "respTime": "20200925133904",
              "orgSeq": "000100012020091412000012345678",
              "UDIASeq": "2412e26d1ca346f398e72bea15c51899",
              "currentSize": 4,
              "totalPage": 1,
              "currentPage": 1,
              "comUsers": [{
                     "origOrgSeq": "000100012020091418343552244338",
                     "origUDIASeq": "623835d3-8b73-4e9b-a225-bd72a8e74bbe",
                     "origComUserId": "0001000100000001",
                     "origAuthRes": "01",
                     "origAuthExt ": "验证一致"
              }, {
                     "origOrgSeq": "000100012020091418343407412556",
                     "origUDIASeq": "51843b7d-b137-4eb4-ac62-f57b3a8ee379",
                     "origComUserId": "0001000100000001",
                     "origAuthRes": "01",
                     "origAuthExt ": "验证一致"
              }, {
                     "origOrgSeq": "000100012020091418343092036043",
                     "origUDIASeq": "df7be0b6-940b-4eb9-8a6b-c492ed2ee017",
                     "origComUserId": "0001000100000001",
                     "origAuthRes": "01",
                     "origAuthExt ": "验证一致"
              }, {
                     "origOrgSeq": "000100012020091418342359742098",
                     "origUDIASeq": "dd7467a7-1640-4748-ac48-2f7a939a30aa",
                     "origComUserId": "0001000100000001",
                     "origAuthRes": "01",
                     "origAuthExt ": "验证一致"
              }]
       }
}
R
以上内容对您是否有帮助?
有帮助
无帮助
哪些方面为您提供了帮助?
内容易于找到
内容更新及时
内容通俗易懂
步骤清晰明了
阅读体验良好
图片/代码清晰
立即提交
请留下您的宝贵意见
找不到内容
更新不及时
描述不清晰
链接有错误
内容不完整
图片不清晰
立即提交

联系我们

咨询与服务