{
  "openapi": "3.0.3",
  "info": {
    "title": "身份证2要素银行卡234要素实名核验-企业专享",
    "description": "身份证二要素-身份证实名核验-银行卡二要素-三要素-四要素-银行卡实名核验接口，输入姓名、身份证号，校验此两项信息是否真实匹配一致，同时返回生日、性别、籍贯等信息；输入姓名、身份证号，卡号，手机号，校验此四项信息是否真实匹配一致，同时对应信息【该接口仅限企业用户使用】",
    "termsOfService": "https://www.showapi.com/helpcenter/view#/4019/2",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://route.showapi.com"
    }
  ],
  "paths": {
    "/1072-5": {
      "x-pointCode": 5,
      "x-mode": "mapping",
      "x-read-timeout": 60,
      "x-connect-timeout": 30,
      "post": {
        "summary": "银行卡四元素验证",
        "description": "根据银行卡号、持卡人姓名、身份证号、银行卡绑定手机号，验证此四项是否匹配一致\n\n注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。\n当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。\n2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过10次我们将进行扣费。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "number",
                              "description": "验证标示： \n0：成功 \n4：此卡被没收,请于发卡方联系 \n5：持卡人认证失败 \n14：无效卡号 \n15：此卡无对应发卡方 \n21：该卡未初始化或睡眠卡 \n34：作弊卡,吞卡 \n40：发卡方不支持的交易 \n41：此卡已经挂失 \n43：此卡被没收 \n54：该卡已过期 \n57：发卡方不允许此交易 \n62：受限制的卡 \n75：密码错误次数超限 \n82：身份证号码有误 \n83：银行卡号码有误 \n84：手机号码输入格式有误 \n86：持卡人信息有误 \n87：未开通无卡支付 \n96：交易失败请重试 \n100：渠道异常，请稍后再试 \n101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验 103：24小时内相同姓名或卡号核验次数超限"
                            },
                            "msg": {
                              "type": "string",
                              "description": "验证结果描述"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "调用成功与否，0为成功，其他值为失败"
                            },
                            "belong": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "area": {
                                    "type": "string",
                                    "description": "地区，注意不是所有卡都能返回area字段。"
                                  },
                                  "tel": {
                                    "type": "string",
                                    "description": "银行客服电话"
                                  },
                                  "brand": {
                                    "type": "string",
                                    "description": "银行卡产品名称"
                                  },
                                  "bankName": {
                                    "type": "string",
                                    "description": "银行名称"
                                  },
                                  "cardType": {
                                    "type": "string",
                                    "description": "银行卡种"
                                  },
                                  "url": {
                                    "type": "string",
                                    "description": "银行官网"
                                  },
                                  "cardNum": {
                                    "type": "string",
                                    "description": "传入的卡号"
                                  },
                                  "simpleCode": {
                                    "type": "string",
                                    "description": "英文简称缩写"
                                  },
                                  "formatBankName": {
                                    "type": "string",
                                    "description": "规范化的银行名称"
                                  },
                                  "logo": {
                                    "type": "string",
                                    "description": "银行logo"
                                  }
                                }
                              },
                              "description": "银行卡资料"
                            },
                            "order": {
                              "type": "string",
                              "description": "调用id"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "1072_5_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "acct_pan": {
                    "type": "string",
                    "description": "银行卡帐号"
                  },
                  "acct_name": {
                    "type": "string",
                    "description": "持卡人姓名"
                  },
                  "phone_num": {
                    "type": "string",
                    "description": "绑定手机号"
                  },
                  "cert_type": {
                    "type": "string",
                    "description": "开卡使用的证件类型；01:身份证，目前只支持身份证"
                  },
                  "cert_id": {
                    "type": "string",
                    "description": "开卡使用的证件号码"
                  },
                  "needBelongArea": {
                    "type": "string",
                    "description": "是否需要返回银行卡归属地信息"
                  }
                },
                "required": [
                  "acct_pan",
                  "acct_name",
                  "phone_num",
                  "cert_type",
                  "cert_id"
                ]
              }
            }
          }
        }
      }
    },
    "/1072-4": {
      "x-pointCode": 4,
      "x-mode": "mapping",
      "x-read-timeout": 60,
      "x-connect-timeout": 30,
      "post": {
        "summary": "银行卡三元素验证",
        "description": "根据银行卡号、持卡人姓名、身份证号，验证此三项是否匹配一致\n\n注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。\n当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。\n2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过10次我们将进行扣费。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "number",
                              "description": "验证标示： \n0：成功 \n4：此卡被没收,请于发卡方联系 \n5：持卡人认证失败 \n14：无效卡号 \n15：此卡无对应发卡方 \n21：该卡未初始化或睡眠卡 \n34：作弊卡,吞卡 \n40：发卡方不支持的交易 \n41：此卡已经挂失 \n43：此卡被没收 \n54：该卡已过期 \n57：发卡方不允许此交易 \n62：受限制的卡 \n75：密码错误次数超限 \n82：身份证号码有误 \n83：银行卡号码有误 \n84：手机号码输入格式有误 \n86：持卡人信息有误 \n87：未开通无卡支付 \n96：交易失败请重试 \n100：渠道异常，请稍后再试 \n101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验 103：24小时内相同姓名或卡号核验次数超限"
                            },
                            "msg": {
                              "type": "string",
                              "description": "验证结果描述"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "调用成功与否，0为成功，其他值为失败"
                            },
                            "belong": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "area": {
                                    "type": "string",
                                    "description": "地区，注意不是所有卡都能返回area字段。"
                                  },
                                  "tel": {
                                    "type": "string",
                                    "description": "银行客服电话"
                                  },
                                  "brand": {
                                    "type": "string",
                                    "description": "银行卡产品名称"
                                  },
                                  "bankName": {
                                    "type": "string",
                                    "description": "银行名称"
                                  },
                                  "cardType": {
                                    "type": "string",
                                    "description": "银行卡种"
                                  },
                                  "url": {
                                    "type": "string",
                                    "description": "银行官网"
                                  },
                                  "cardNum": {
                                    "type": "string",
                                    "description": "传入的卡号"
                                  },
                                  "logo": {
                                    "type": "string",
                                    "description": "银行logo"
                                  },
                                  "formatBankName": {
                                    "type": "string",
                                    "description": "规范化的银行名称"
                                  },
                                  "simpleCode": {
                                    "type": "string",
                                    "description": "英文简称缩写"
                                  }
                                }
                              },
                              "description": "银行卡资料"
                            },
                            "order": {
                              "type": "string",
                              "description": "调用id"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "1072_4_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "acct_pan": {
                    "type": "string",
                    "description": "银行卡帐号"
                  },
                  "acct_name": {
                    "type": "string",
                    "description": "持卡人姓名"
                  },
                  "cert_type": {
                    "type": "string",
                    "description": "开卡使用的证件类型；01:身份证，目前只支持身份证"
                  },
                  "cert_id": {
                    "type": "string",
                    "description": "开卡使用的证件号码"
                  },
                  "needBelongArea": {
                    "type": "string",
                    "description": "是否需要返回银行卡归属地信息"
                  }
                },
                "required": [
                  "acct_pan",
                  "acct_name",
                  "cert_type",
                  "cert_id"
                ]
              }
            }
          }
        }
      }
    },
    "/1072-2": {
      "x-pointCode": 2,
      "x-mode": "mapping",
      "x-read-timeout": 60,
      "x-connect-timeout": 30,
      "post": {
        "summary": "银行卡二元素验证",
        "description": "验证银行卡号与持有人姓名是否匹配\n\n注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。\n当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。\n2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过10次我们将进行扣费。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "ret_code": {
                              "type": "number",
                              "description": "调用成功与否，0为成功，计费，其他值为失败"
                            },
                            "order": {
                              "type": "string",
                              "description": "订单号"
                            },
                            "belong": {
                              "type": "object",
                              "properties": {
                                "logo": {
                                  "type": "string",
                                  "description": "银行logo"
                                },
                                "area": {
                                  "type": "string",
                                  "description": "归属地"
                                },
                                "simpleCode": {
                                  "type": "string",
                                  "description": "英文简称缩写"
                                },
                                "tel": {
                                  "type": "string",
                                  "description": "电话"
                                },
                                "bankName": {
                                  "type": "string",
                                  "description": "银行名称"
                                },
                                "cardType": {
                                  "type": "string",
                                  "description": "卡类型"
                                },
                                "url": {
                                  "type": "string",
                                  "description": "相关网址"
                                },
                                "cardNum": {
                                  "type": "string",
                                  "description": "卡号"
                                },
                                "brand": {
                                  "type": "string",
                                  "description": "银行卡种"
                                },
                                "formatBankName": {
                                  "type": "string",
                                  "description": "规范化的银行名称"
                                }
                              },
                              "description": "银行卡信息"
                            },
                            "code": {
                              "type": "number",
                              "description": "验证标示： \n0：成功 \n4：此卡被没收,请于发卡方联系 \n5：持卡人认证失败 \n14：无效卡号 \n15：此卡无对应发卡方 \n21：该卡未初始化或睡眠卡 \n34：作弊卡,吞卡 \n40：发卡方不支持的交易 \n41：此卡已经挂失 \n43：此卡被没收 \n54：该卡已过期 \n57：发卡方不允许此交易 \n62：受限制的卡 \n75：密码错误次数超限 \n82：身份证号码有误 \n83：银行卡号码有误 \n84：手机号码输入格式有误 \n86：持卡人信息有误 \n87：未开通无卡支付 \n96：交易失败请重试 \n100：渠道异常，请稍后再试 \n101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验 103：24小时内相同姓名或卡号核验次数超限"
                            },
                            "msg": {
                              "type": "string",
                              "description": "调用说明"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "1072_2_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "acct_pan": {
                    "type": "string",
                    "description": "银行卡帐号"
                  },
                  "acct_name": {
                    "type": "string",
                    "description": "持卡人姓名"
                  },
                  "needBelongArea": {
                    "type": "string",
                    "description": "是否需要返回银行卡归属地信息"
                  }
                },
                "required": [
                  "acct_pan",
                  "acct_name"
                ]
              }
            }
          }
        }
      }
    },
    "/1072-1": {
      "x-pointCode": 1,
      "x-mode": "mapping",
      "x-read-timeout": 30,
      "x-connect-timeout": 30,
      "post": {
        "summary": "身份证实名验证",
        "description": "【身份证实名认证-身份证二要素核验】输入姓名和身份证号，校验此二要素是否一致，同时返回性别、生日和籍贯等信息。广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。直连官方，实时核验，毫秒级响应，零缓存！\n\n注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。\n当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。\n2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过10次我们将进行扣费。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ShowapiResEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "showapi_res_body": {
                          "type": "object",
                          "properties": {
                            "birthday": {
                              "type": "string",
                              "description": "生日"
                            },
                            "ret_code": {
                              "type": "number",
                              "description": "0为成功，计费，其余为失败，不计费"
                            },
                            "sex": {
                              "type": "string",
                              "description": "性别：M为男性，F为女性"
                            },
                            "order": {
                              "type": "string",
                              "description": "相关流水号"
                            },
                            "county": {
                              "type": "string",
                              "description": "区县"
                            },
                            "address": {
                              "type": "string",
                              "description": "详细地址"
                            },
                            "province": {
                              "type": "string",
                              "description": "省"
                            },
                            "code": {
                              "type": "number",
                              "description": "验证标示\n0：匹配\n1：不匹配\n2：无此身份证号码\n3：身份证号与姓名匹配，照片比对失败\n4：参数不能为空\n5：四要素匹配成功，照片比对失败\n6：四要素匹配失败，照片比对成功\n7: 四要素匹配成功，照片异常\n12：身份证号码不合法\n13: 照片质量异常\n14: 姓名异常\n15: 暂不支持该地域校验\n100：渠道异常，请稍后再试\n101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验\n102：维护中\n103：24小时内相同姓名或卡号核验次数超限\n104：decrypt参数异常\n202：姓名加密信息有误，请检查\n203：身份证加密信息有误，请检查\n205：开始时间加密信息有误，请检查\n206：结束时间加密信息有误，请检查\n207：人像照片加密信息有误，请检查"
                            },
                            "msg": {
                              "type": "string",
                              "description": "说明"
                            },
                            "city": {
                              "type": "string",
                              "description": "城市"
                            }
                          },
                          "description": "业务返回体"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "operationId": "1072_1_POST",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "idcard": {
                    "type": "string",
                    "description": "身份证号，测试时注意不要填错，填错一样扣减使用次数"
                  },
                  "name": {
                    "type": "string",
                    "description": "姓名，测试时注意不要填错，填错一样扣减使用次数"
                  }
                },
                "required": [
                  "idcard",
                  "name"
                ]
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "AppKeyAuth": {
        "type": "apiKey",
        "in": "query",
        "name": "appKey",
        "description": "从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp"
      }
    },
    "schemas": {
      "ShowapiResEnvelope": {
        "type": "object",
        "description": "ShowAPI 统一返回包裹（业务数据位于 showapi_res_body）",
        "properties": {
          "showapi_res_code": {
            "type": "integer",
            "description": "API 返回的状态码"
          },
          "showapi_res_error": {
            "type": "string",
            "description": "API 返回的错误信息"
          },
          "showapi_res_id": {
            "type": "string",
            "description": "API 请求的唯一标识"
          },
          "showapi_fee_num": {
            "type": "integer",
            "description": "API 调用计费次数"
          }
        }
      }
    }
  },
  "security": [
    {
      "AppKeyAuth": []
    }
  ],
  "externalDocs": {
    "url": "https://www.showapi.com/apiGateway/view/1072?tab=book"
  },
  "x-apiCode": "1072",
  "x-is-own": false,
  "x-is-op": true
}