# Generated by ShowAPI OpenAPI generator
# source: market/30
# generated-at: 2026-06-26T04:56:25.906Z
openapi: 3.0.3
info:
  title: 银行卡归属地查询
  description: 支持全国500+银行卡查询，银行卡归属地-银行卡开户行查询，支持中国银行、农行、建行、邮政、交通银行、招商银行、浦发银行、兴业银行、华夏银行、民生银行、光大银行等多家卡种。基本资料查询（银行名称、卡类型（是借记卡还是信用卡）， 没有查到归属地不扣次数。
  termsOfService: https://www.showapi.com/helpcenter/view#/4019/2
  version: 1.0.0
servers:
  - url: https://route.showapi.com
paths:
  /30-7:
    x-pointCode: 7
    x-mode: mapping
    x-read-timeout: 30
    x-connect-timeout: 30
    post:
      summary: 银行卡归属信息查询
      description: 通过银行卡号,查询银行卡的归属地,并附加返回卡号对应的地区、银行名、电话号码、网址、卡种、银联luhn和Bin码等信息.当归属地查询失败的时候,不扣费.
      responses:
        "200":
          description: 成功响应
          content:
            application/json:
              schema:
                allOf:
                  - $ref: "#/components/schemas/ShowapiResEnvelope"
                  - type: object
                    properties:
                      showapi_res_body:
                        type: object
                        properties:
                          area:
                            type: string
                            description: 地区
                          cardType:
                            type: string
                            description: 银行卡种
                          brand:
                            type: string
                            description: 银行卡产品名称（品牌），枚举值见文档（帮助手册），可能返回枚举值外的其他值，但概率很小
                          tel:
                            type: string
                            description: 银行客服
                          bankName:
                            type: string
                            description: 银行名称
                          url:
                            type: string
                            description: 银行官网
                          ret_code:
                            type: string
                            description: 0为成功，其他失败
                          simpleCode:
                            type: string
                            description: 银行简码（该字段为银联支付网关简码，不一定有该字段返回）
                          formatBankName:
                            type: string
                            description: 规范化的银行名称，部分银行为空字符串，枚举值见文档（帮助手册）
                          logo:
                            type: string
                            description: 银行logo，部分银行为空字符串
                          card_bin:
                            type: string
                            description: 银行卡Bin码（需要请求参数中needBin=1才有该值返回）当无法查询到该银行卡bin码时返回空字符串
                          bin_digits:
                            type: string
                            description: 银行卡Bin码长度（需要请求参数中needBin=1才有该值返回）
                          card_digits:
                            type: string
                            description: 银行卡卡号长度（需要请求参数中needBin=1才有该值返回）
                          isLuhn:
                            type: string
                            description: 是否能通过中国银联Luhn效验，1表示可以，0表示不能，空字符串表示不支持（需要请求参数中needBin=1才有该值返回）
                        description: 业务返回体
      operationId: 30_7_POST
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                cardNum:
                  type: string
                  description: 银行卡号
                needBin:
                  type: string
                  description: 是否需要返回银行卡BIN码信息和银联luhn效验。1表示需要，0表示不需要，默认不会返回这些信息，返回这些信息将使得查询更加耗时。
              required:
                - cardNum
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/30?tab=book
x-apiCode: "30"
x-is-own: false
x-is-op: true
