# Generated by ShowAPI OpenAPI generator
# source: market/1072
# generated-at: 2026-06-26T01:55:35.164Z
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: |-
        根据银行卡号、持卡人姓名、身份证号、银行卡绑定手机号，验证此四项是否匹配一致

        注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。
        当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
        2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过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: |-
                              验证标示： 
                              0：成功 
                              4：此卡被没收,请于发卡方联系 
                              5：持卡人认证失败 
                              14：无效卡号 
                              15：此卡无对应发卡方 
                              21：该卡未初始化或睡眠卡 
                              34：作弊卡,吞卡 
                              40：发卡方不支持的交易 
                              41：此卡已经挂失 
                              43：此卡被没收 
                              54：该卡已过期 
                              57：发卡方不允许此交易 
                              62：受限制的卡 
                              75：密码错误次数超限 
                              82：身份证号码有误 
                              83：银行卡号码有误 
                              84：手机号码输入格式有误 
                              86：持卡人信息有误 
                              87：未开通无卡支付 
                              96：交易失败请重试 
                              100：渠道异常，请稍后再试 
                              101：验证信息重复输入，避免恶意验证请间隔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: |-
        根据银行卡号、持卡人姓名、身份证号，验证此三项是否匹配一致

        注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。
        当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
        2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过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: |-
                              验证标示： 
                              0：成功 
                              4：此卡被没收,请于发卡方联系 
                              5：持卡人认证失败 
                              14：无效卡号 
                              15：此卡无对应发卡方 
                              21：该卡未初始化或睡眠卡 
                              34：作弊卡,吞卡 
                              40：发卡方不支持的交易 
                              41：此卡已经挂失 
                              43：此卡被没收 
                              54：该卡已过期 
                              57：发卡方不允许此交易 
                              62：受限制的卡 
                              75：密码错误次数超限 
                              82：身份证号码有误 
                              83：银行卡号码有误 
                              84：手机号码输入格式有误 
                              86：持卡人信息有误 
                              87：未开通无卡支付 
                              96：交易失败请重试 
                              100：渠道异常，请稍后再试 
                              101：验证信息重复输入，避免恶意验证请间隔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: |-
        验证银行卡号与持有人姓名是否匹配

        注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。
        当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
        2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过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: |-
                              验证标示： 
                              0：成功 
                              4：此卡被没收,请于发卡方联系 
                              5：持卡人认证失败 
                              14：无效卡号 
                              15：此卡无对应发卡方 
                              21：该卡未初始化或睡眠卡 
                              34：作弊卡,吞卡 
                              40：发卡方不支持的交易 
                              41：此卡已经挂失 
                              43：此卡被没收 
                              54：该卡已过期 
                              57：发卡方不允许此交易 
                              62：受限制的卡 
                              75：密码错误次数超限 
                              82：身份证号码有误 
                              83：银行卡号码有误 
                              84：手机号码输入格式有误 
                              86：持卡人信息有误 
                              87：未开通无卡支付 
                              96：交易失败请重试 
                              100：渠道异常，请稍后再试 
                              101：验证信息重复输入，避免恶意验证请间隔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: |-
        【身份证实名认证-身份证二要素核验】输入姓名和身份证号，校验此二要素是否一致，同时返回性别、生日和籍贯等信息。广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。直连官方，实时核验，毫秒级响应，零缓存！

        注意：1.当请求参数符合“【固定同一个参数，其余参数不同】，”比如“【同一个身份证，不同姓名】”，并且检验次数为<=10次，认为正常调用。
        当>10次以上，我们认为是恶意调用，此时返回【24小时内相同姓名或卡号核验次数超限】，不扣费。
        2.当请求参数存在明显错误（比如身份证号位数错误），二十四小时内同一个错误参数调用超过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: |-
                              验证标示
                              0：匹配
                              1：不匹配
                              2：无此身份证号码
                              3：身份证号与姓名匹配，照片比对失败
                              4：参数不能为空
                              5：四要素匹配成功，照片比对失败
                              6：四要素匹配失败，照片比对成功
                              7: 四要素匹配成功，照片异常
                              12：身份证号码不合法
                              13: 照片质量异常
                              14: 姓名异常
                              15: 暂不支持该地域校验
                              100：渠道异常，请稍后再试
                              101：验证信息重复输入，避免恶意验证请间隔60秒以上再次核验
                              102：维护中
                              103：24小时内相同姓名或卡号核验次数超限
                              104：decrypt参数异常
                              202：姓名加密信息有误，请检查
                              203：身份证加密信息有误，请检查
                              205：开始时间加密信息有误，请检查
                              206：结束时间加密信息有误，请检查
                              207：人像照片加密信息有误，请检查
                          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
