> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtenha informações sobre o BIN

Valide um Bank Identification Number (BIN) para verificar a validade do cartão e obter detalhes importantes, como emissor, bandeira, tipo e país. Use esta verificação para evitar falhas de pagamento causadas por dados de cartão inválidos.

> **Lembre-se**
>
> O `countryCode ` na resposta está no formato ISO-3166-1 Alpha-2. Certifique-se de converter este valor para o padrão ISO-3166-1 Alpha-3 antes de enviá-lo a outros endpoints do nosso sistema.


## OpenAPI

````yaml openapi/pt-br/localpayment.json GET /api/resources/bin-validation
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/resources/bin-validation:
    get:
      summary: Obtenha informações sobre o BIN
      operationId: get-bin-info
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acesso Bearer para autenticação. Este token é obtido nos
            endpoints [Obter token de acesso](/pt-br/reference/get-token) ou
            [Renovar token de acesso](/pt-br/reference/refresh-token).
          required: true
          schema:
            type: string
        - name: bin
          in: query
          description: Número de identificação bancária.
          required: true
          schema:
            type: string
            examples:
              - '400000'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  bin:
                    type: string
                    description: Número de identificação bancária.
                  bank:
                    type: string
                    description: Banco emissor do cartão.
                  card:
                    type: string
                    description: Rede de pagamento com cartão.
                  type:
                    type: string
                    enum:
                      - CREDIT
                      - DEBIT
                    description: Tipo de cartão.
                  level:
                    type: string
                    description: Nível do cartão.
                  country:
                    type: string
                    description: Nome do país.
                  CountryCode:
                    type: string
                    title: CountryCode
                    description: Código do país. ISO 3166-1 alfa-2.
                  website:
                    type: string
                    description: Site do emissor.
                  phone:
                    type: string
                    description: Telefone do emissor.
                  valid:
                    type: boolean
                    description: Indica se o BIN informado é válido.
                required:
                  - bin
                  - bank
                  - card
                  - type
                  - level
                  - country
                  - CountryCode
                  - website
                  - phone
                  - valid
                x-examples:
                  Example 1:
                    bin: '424242'
                    bank: ''
                    card: VISA
                    type: CREDIT
                    level: ''
                    country: United Kingdom of Great Britain and Northern Ireland
                    countryCode: GB
                    website: ''
                    phone: ''
                    valid: true
              examples:
                200 - BIN info.:
                  value:
                    bin: '40000000'
                    bank: INTL HDQTRS-CENTER OWNED
                    card: VISA
                    type: CREDIT
                    level: TRADITIONAL
                    country: United States of America
                    countryCode: US
                    website: ''
                    phone: ''
                    valid: true
        '400':
          description: Solicitação inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  bin:
                    type: string
                    description: Número de identificação bancária.
                  valid:
                    type: boolean
                    description: Indica se o BIN informado é válido.
                  error:
                    type: string
                    description: Mensagem de erro.
                  message:
                    type: string
                    description: Informações adicionais sobre o erro.
                required:
                  - bin
                  - valid
                  - error
                  - message
                x-examples:
                  Example 1:
                    bin: '40000'
                    valid: false
                    error: bincheck.io error
                    message: The BIN number is less than 6 digits.
              examples:
                400 - BIN length error.:
                  value:
                    bin: '40000'
                    valid: false
                    error: bincheck.io error
                    message: The BIN number is less than 6 digits.
                1011 - Invalid BIN:
                  value:
                    bin: 40000-3
                    valid: false
                    error: '1011'
                    message: Invalid BIN
        '401':
          description: Não autorizado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Informações adicionais sobre a resposta.
                  code:
                    type: string
                    description: Código de status.
                  messages:
                    type: array
                    description: Lista de mensagens.
                    items:
                      type: object
                      properties:
                        token_class:
                          type: string
                          description: Classe Token.
                        token_type:
                          type: string
                          description: Tipo de token.
                        message:
                          type: string
                          description: Mensagem com informações adicionais.
                x-examples:
                  Example 1:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
              examples:
                401 - Token is invalid or expired:
                  value:
                    detail: Given token not valid for any token type
                    code: token_not_valid
                    messages:
                      - token_class: AccessToken
                        token_type: access
                        message: Token is invalid or expired
      security:
        - token: []
      servers:
        - url: https://api.stage.localpayment.com
          description: Stage
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.