API de Tabela de BINs permite que o estabelecimento comercial identifique uma transação Elo e realize o roteamento adequado de autorização, possibilitando ainda utilização destas informações para fins de prevenção de fraudes.

1. Leia [Introdução ao GraphQL](/blog/introducao-ao-graphql), com exemplos reais da nossa API.
2. [Crie uma conta](https://dev.elo.com.br/cadastre-se) no portal do desenvolvedor.
3. Cadastre sua primeira aplicação. 
4. Utilize o dashboard para acessar suas configurações de acesso.
5. Para explorar rapidamente as APIs aqui na página de documentação, use o console de GraphQL, na seção de referências. Nele, você pode ver as consultas de exemplo, executá-las e alterá-las.


Primeiros passos

Todas as chamadas desta API exigem que o `client_id` e o `Content-Type: application/json` estejam presentes nos cabeçalhos da requsição. Cabeçalhos necessários para as chamadas:

<table align="center" border="1" bordercolor="#C0C0C0" cellspacing="0" style="font-size: 1.8rem; font-family: Museo Sans,Helvetica,sans-serif">
  <thead>
    <tr>
      <th style="padding: 5px;">Chave</th>
      <th style="padding: 5px;">Obrigatório</th>
      <th style="padding: 5px;">Descrição</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="left" style="padding: 5px">Content-Type</td>
      <td align="left" style="padding: 5px">Sim</td>
      <td align="left" style="padding: 5px">Define o tipo de dado transferido na chamada</td>
    </tr>
    <tr>
      <td align="left" style="padding: 5px">client_id</td>
      <td align="left" style="padding: 5px">Sim</td>
      <td align="left" style="padding: 5px">Identificador da aplicação cliente obtida no portal</td>
    </tr>
  </tbody>
</table>

HTTP Headers

O número do cartão (PAN - *Primary Account Number*) é segmentado por prefixos chamados "BIN", sigla em inglês para Bank Identification Number ou Número de Identificação do Banco.

O tamanho do prefixo, também conhecido como "tamanho do BIN", diz quantos dígitos à esquerda do número do cartão são utilizados. Originalmente era de apenas 4 dígitos, hoje são 6 e espera-se que chegue até 9 dígitos. Logo o tamanho é parametrizado como uma faixa, informada na consulta `binTable { sizeRange }` (veja mais a seguir).

Como o tamanho do BIN impacta no tamanho do número do cartão (PAN), cada BIN parametriza os tamanhos de PAN que ele espera, também como uma faixa na consulta `BIN { panSizeRange }`.

Uma vez reconhecido o BIN, pode-se então consultar o sistema por diversos atributos, tais como:
 - Qual o país de origem (domicílio) do cartão? `BIN { country }`
 - O cartão pode ser utilizado internacionalmente? `BIN { isInternational }`
 - Qual o financiamento do cartão? crédito, débito, múltiplo (ambos)? `BIN { funding }`
 - É um cartão corporativo ou de pessoas físicas? `BIN { isCompany }`
 - É um cartão real ou virtual (CardToken)? `BIN { isToken }`
 - Onde posso capturar o cartão? (Ex. Caixa Eletrônico, Ponto de Venda, Internet...) `BIN { allowedCaptures }`
 - Quais tipo de uso? (Ex. Crédito à Vista, Crédito Parcelado pela Loja, Débito...) `BIN { usage }`
 - Qual é a bandeira do cartão? `BIN { brand }`
 - Qual rede o cartão pode ser utilizado? (Ex. Elo, Elo-Discovery...) `BIN { cardNetwork }`
 - Qual o emissor (banco) do cartão? `BIN { issuer }`
 - Quais serviços ao portador o cartão oferece? (Ex. Seguro Viagem) `BIN { services }`
 - Quais serviços ao portador o cartão permite trocar? (Ex. Auto Emergência I) `BIN { changeableServices }`

__Nota__: *Os dados da API são coletados direto da base produtiva, portanto os valores retornados é o mais atualizado possivel.*

Introdução

Um BIN pode ser consultado com a consulta `bin(id)`:

*Exemplo do corpo da requisição:*

```graphql.copy
query OneBin {
  bin(number: "509069") { # Banco do Brasil - Grafite

    # Deverá retornar Banco do Brasil
    issuer {
      name
    }

    # Deverá retornar Grafite
    product {
      name
    }

    # Capturas permitidas (i.e: ponto de venda `POS`, Internet,
    # Telemarketing...)
    allowedCaptures {
      name
      code
    }

    # Usos permitidos (i.e: Crédito à Vista, Débito, Parcelado pela
    # Loja...)
    usages {
      name
      code
    }

    # Serviços (benefícios) ao portador (i.e: Seguro de Viagem,
    # Proteção de Compra, Garantia Estendida, WiFi)
    services {
      name
      isExchangeableOffer
    }

    # Serviços (benefícios) que podem ser trocados 
    # (i.e: Auto Emergência I, Wi-Fi)
    changeableServices {
      name
    }
  }
}
```

Tais parâmetros podem ser utilizados por terceiros, por exemplo, um comerciante, para validação do cartão e até prevenção à fraude. No entanto, consultar um BIN por vez pode não ser eficiente, já que os BINs não mudam com tanta frequência. Seria melhor baixar uma cópia de toda a tabela.

*Exemplo de resposta:*

```json
{
  "data": {
    "bin": {
      "issuer": {
        "name": "BANCO DO BRASIL SA"
      },
      "product": {
        "name": "Grafite"
      },
      "allowedCaptures": [
        {
          "name": "POS",
          "code": 1
        },
        {
          "name": "TEF",
          "code": 2
        },
        {
          "name": "INTERNET",
          "code": 3
        },
        {
          "name": "TELEMARKETING",
          "code": 4
        },
        {
          "name": "ATM",
          "code": 5
        }
      ],
      "usages": [
        {
          "name": "Débito Elo à Vista",
          "code": 0
        },
        {
          "name": "Crédito Elo à vista ",
          "code": 0
        },
        {
          "name": "Elo Parcelado Loja",
          "code": 0
        }
      ],
      "services": [],
      "changeableServices": []
    }
  }
}
```

Consultando um único BIN

Para isso, era utilizada a consulta `binTable`, a qual retornava uma lista de todos os BINs. Porém este recurso foi depreciado e agora esta lista está disponível apenas através do arquivo CSV localizado na próxima seção [Download csv](https://dev.elo.com.br/documentacao/tabela-de-bins#tabela-de-bins-ou-download-csv).

Para visualizá-la, é necessário estar autenticado no portal.


Baixando toda a Tabela de BINs

[Download csv](https://dev.elo.com.br/api/bins)

Download csv

Abaixo, você verá uma lista de erros comuns e suas descrições.

- **200 OK** - POST body missing. Did you forget use body-parser middleware?: O header Content-Type não foi passado nos cabeçalhos da requisição ou está inválido.

- **200 OK** - POST Cannot return null for non-nullable field BIN.issuer: 
número do bin inválido.

- **401 Unauthorized** - Could not find a required APP in the request, identified by HEADER client_id.: O client_id não foi passado nos cabeçalhos da requsição ou ele não existe.

- **400 Bad Request** - Syntax Error: Expected Name, found } : Erro de sintaxe no body que foi enviado no corpo requisição.

Erros Comuns

Tabela de bins

Financiamento do cartão: crédito, débito, múltiplo, Alimentação e Refeição.

CardFunding

CREDIT

DEBIT

Cartão de Crédito e Débito (ambos simultaneamente).

MULTIPLE

MEAL

FOOD

PREPAID

VOUCHER

MULTIPLE_PREPAID

O número do BIN, que por sua vez é um prefixo do número do
cartão (PAN - _Primary Account Number_), ou seja pega-se os
primeiros dígitos (à esquerda).

A quantidade de dígitos é parametrizada em `binTable { sizeRange
}`, por exemplo `{ min: 6, max: 9 }` indica que o sistema
suporta BIN de tamanhos 6, 7, 8 e 9.

number

Consulta informações de BIN de um dado número

Se o número não estiver associado a um BIN alocado, então retorna `null`.

Em geral utilizado apenas em testes ou demonstrações dado que os
usuários baixam toda a tabela com `binTable()` e fazem consultas
locais.  Dado que a frequência de atualizações é baixa (1 vez por
semana).

ifModifiedSince

ifNoneMatch

cardIssuerName

code

Baixa toda a tabela caso a tabela tenha sido modificada depois de
uma certa data ou versão.

`ifModifiedSince` e `ifNoneMatch` são equivalentes ao uso no HTTP
(`If-Modified-Since` para `Last-Modified`, `If-None-Match` para
`ETag`) e podem ser utilizados para buscar por atualizações em uma
única chamada.

Caso `ifModifiedSince` e `ifNoneMatch` sejam especificados e a
tabela não tenha sido alterada, `null` é retornado indicando que a
tabela não mudou.

binTable

Define uma faixa de números inteiros.

Tanto `min` quanto `max` são inclusos na faixa. Ou seja:
 - `min: 10, max: 12` define os números: 10, 11 e 12;
 - `min: 100, max: 100` define apenas o número 100.

Número mínimo (inicial), incluso na faixa.

Número máximo (final), incluso na faixa.

IntRange

Informação de produto associado ao cartão

Cada cartão é relacionado a um produto. No caso da **Elo**, exemplos
de produto são:
 - Básico
 - Clássico
 - Corporativo
 - Grafite
 - Nanquim
 - Viagem
 - Pré-pago

Identificador Global Único para este objeto

Nome do produto.

Exemplos de Produtos **Elo**:
 - Básico
 - Clássico
 - Corporativo
 - Grafite
 - Nanquim
 - Viagem
 - Pré-pago

name

Caso fornecido, largura da imagem, em _pixels_.

width

Caso fornecido, altura da imagem, em _pixels_.

height

Caso fornecido, o tipo de arquivo desejado (`mime-type`).

mimeType

URL da imagem.
Caso sejam providos sugestões de altura e largura (opcionais) para
o tamanho a ser mostrado, o servidor irá retornar a URL para a imagem
com o tamanho mais próximo ao requisitado.
Caso seja provido o `mimeType`, a este será dada preferência, o que
é muito útil em dispositivos que lidam com um único formato de imagens.
Tanto o tamanho quanto o `mimeType` da imagem apontada pela URL
são retornados.

image

CardProduct

Bandeira (marca) do cartão

A bandeira do cartão atualmente retorna **Elo**.

CardBrand

Modo de captura (entrada) do cartão.

O modo de captura define como o cartão pode ser utilizado, exemplos
tradicionais:
 - POS (_Point of Sale_, ou Ponto de Venda)
 - TEF (Transferência Eletrônica de Fundos)
 - Internet (lojas virtuais, _e-commerce_)
 - Telemarketing (centrais de venda por telefone)
 - ATM (_Automated Teller Machine_, ou Caixa Eletrônico)

Código Bancário da Captura

Nos sistemas tradicionais pode ser necessário transitar o código
da captura, que é fornecido por este número.

Por exemplo:
 - OUTROS = 0
 - POS = 1
 - TEF = 2
 - INTERNET = 3
 - TELEMARKETING = 4
 - ATM = 5
 - E-COMMERCE = 7
 - CONTA CARTÃO ARMAZENADA = 10
 - CONTACTLESS = 81
 - MOBILE COMMERCE (MCOMMERCE) = 82
 - CONTACTLESS = 83
 - FALLBACK = 85
 - CONTACTLESS = 86
 - TARJA TOTAL = 90
 - VOICE RESPONSE UNIT (VRU) / (URA) = 91
 - BATCH DE AUTORIZAÇÕES = 92
 - BATCH DE AUTORIZAÇÕES CASH ACCESS = 91
 - CARTÃO COM CHIP SEM TRATAMENTO CVV = 95

CardCapture

Uso de um Cartão.

Define como as compras poderão ser realizadas, por exemplo:
 - Crédito à Vista
 - Débito
 - Parcelado pela loja

Código Bancário do Uso

Nos sistemas tradicionais pode ser necessário transitar o código
do uso, que é fornecido por este número.

Por exemplo:
 - Crédito à Vista = 70
 - Débito = 71
 - Parcelado Loja = 72

CardUsage

Rede para utilização do Cartão

Cada cartão deve ser utilizado em uma rede, por exemplo para cartões
**Elo**:
 - `Elo` para cartões domésticos;
 - `Elo-Discovery` para cartões internacionais.

Nome da Rede

Exemplos para **Elo**:
 - `Elo` para cartões domésticos;
 - `Elo-Discovery` para cartões internacionais.

CardNetwork

legalName

description

legalIds

contacts

addresses

Limita a lista às primeiras entradas, caso provido.
Se for `null`, a listagem é ilimitada.
Utilizado em navegação para frente.

first

Inicia após o cursor opaco, se provido.
Utilizado em navegação para frente.

after

Limita a lista às últimas entradas, caso provido.
Se for `null`, a listagem é ilimitada.
Utilizado em navegação para trás.

last

Inicia antes do cursor opaco, se provido.
Utilizado em navegação para trás.

before

filter

Consulta todos os objetos de cartão (`Card`) disponíveis no contexto.

Se executado por um portador de cartão, serão retornados todos os
cartões que este possui e foram emitidos por este emissor.

Se executado por um emissor de cartão, serão retornados todos os
cartões emitidos por este.

Em outros casos, como ao ser executado por um comerciante, um erro
será produzido.

cards

CardIssuer

Metadados de cartão: como representar o cartão visualmente

Cor de fundo (_background_) em notação web padrão: `#ffffff`
(branco), `#ff0000` (vermelho), `#00ff00` (verde), `#0000ff`
(azul).  Deve ser usado em conjunto com `foregroundColor` quando
não é possível usar imagem.

backgroundColor

Cor de primeiro plano (_foreground_) em notação web padrão:
`#ffffff` (branco), `#ff0000` (vermelho), `#00ff00` (verde),
`#0000ff` (azul).  Deve ser usado em conjunto com
`backgroundColor` quando não é possível usar imagem.

foregroundColor

Emissor de cartão, i.e.: "Um Banco"
Deve ser usado quando não é possível utilizar imagem.

É o mesmo que consultar o `BIN { issuer { name } }`

issuer

Bandeira do cartão, i.e: **Elo**
Deve ser usado quando não é possível utilizar imagem.

É o mesmo que consultar o `BIN { brand { name } }`

brand

Nome do produto associado ao cartão, i.e.: Nanquim, Grafite.

É o mesmo que consultar o `BIN { product { name } }`

product

CardMetadata

Serviço disponível ao portador do cartão.

A Elo oferece aos portadores serviços como acesso à internet, estes
são representados por este tipo.

discounts

Parâmetros de personalização do benefício.

offerParameters

offerItems

Identifica se o benefício é passível de troca por outro benefício equivalente.
false -> não é possivel alterar o benefício
true  -> é possivel alterar o benefício

isExchangeableOffer

CardHolderService

Dados de autorização e liquitação do Cartão.

Identificador da processadora de autorização do Bin.

processorId

Identificador da processadora de liquidação do Bin.

processorSettlementId

Identificador do banco de liquidação deste do Bin.

settlementBankNumber

Se `true`, então o cartão poderá ser utilizado em transações P2P.
Se `false`, então o cartão NÃO poderá ser utilizado em transações P2P.

isP2PEligible

binAuthorization

Representa um BIN (_Bank Identification Number_ ou Número de
Identificação do Banco) no sistema.

O BIN é relativo aos números iniciais de um cartão e identifica
o emissor e produtos associados ao mesmo.

Cada bandeira tem faixas de BIN reservadas a seu uso, estas estão
disponíveis como `reserved` na consulta `binTable`.

Porém o maior
interesse é por BIN em uso (alocados), o qual carregará informações
sobre o emissor (banco), financiamento (`funding`, se crédito,
débito ou ambos), produtos (pagamentos à prazo, pré-pago, Cartão
para construção civil - `Construcard`...) e mesmo serviços como
emissão de seguros ou acesso à WiFi.

A tabela de BIN é dinâmica:

- Conforme os cartões de um mesmo prefixo (BIN) vão sendo
  inutilizados e ficam sem usuários, o BIN pode ser então reciclado
  para um novo uso.

- Conforme novos produtos são inseridos, um BIN previamente
  reservado e sem usuários será então alocado, entrando em uso.

Por isso é importante manter a tabela de BIN atualizada, vide
consulta `binTable`. Para saber se a tabela foi atualizada utilize
os campos de nome similares ao HTTP `lastModified` (data e horário
da última modificação) e `etag` (_entity tag_ ou etiqueta da
entidade), que oferece um identificador único sobre a tabela, se ele
mudou então a tabela mudou.

panSizeRange

funding

country

isInternational

regexp

Se `true`, então o cartão é corporativo, ou seja, pessoa jurídica.
Se `false`, então o cartão é para pessoas físicas.

isCompany

Diz se o cartão é virtual (_token_, vide `CardToken`).

_Tokens_ são muitas vezes compreendidos como "cartões virtuais"
(VCN - _Virtual Card Numbers_), eles são associados a um cartão
real e podem ter maior controle, como restrição de moeda, número
de compras, valor das compras, categoria de comerciante e outros.

O maior uso de _tokens_ é para reduzir problemas com segurança,
seja de um comerciante ou portador.

Se `true`, então este BIN é utilizado para _tokens_ ao invés de
cartões físicos (plástico).
Se `false` então este BIN é utilizado para cartões tradicionais,
físicos (plástico).

isToken

Bandeira do Cartão

A bandeira responsável pelo Cartão. Para cartões da **Elo**,
sempre será `Elo`.

Modos de captura permitidos para o cartão.

Esta lista diz quais os modos de captura são permitidos para o
cartão, por exemplo se `POS` então pode ser utilizado num ponto de
venda (_Point Of Sale_), caso contrário ao tentar utilizá-lo com
tal irá resultar em transação rejeitada.

allowedCaptures

Usos permitidos permitidos para o cartão.

Esta lista diz se o cartão pode ser utilizado para débito, para
crédito à vista, crédito parcelado pela loja, dentre outros.

usages

Rede para uso do Cartão.

Cada cartão deve ser utilizado em uma rede, a qual é listada neste
campo. Por exemplo os cartões **Elo** utilizam as redes:
  - `Elo`: uso doméstico (`isInternational = false`);
  - `Elo-Discovery`: uso internacional.

network

Emissor do cartão.

Todo BIN está associado a um e apenas um emissor, o qual pode ser
consultado com este campo para obtenção do identificador global
único, razão social, nome fantasia, CNPJ, endereço, contatos e
afins.

Metadados para apresentação do cartão ao usuário.

Metadados tais como:
  - imagem
  - cores
Estes deverão ser utilizados para apresentação de um cartão ao usuário
de modo a esclarecer a informação e evitar erros.

metadata

Serviços (benefícios) disponíveis ao portador do cartão.

Os serviços, também conhecidos como benefícios, ao portador. Por
exemplo:
  - Seguro Viagem, para compra de passagens aéreas;
  - Proteção de Compra, para compra de bens;
  - Garantia Estendida, para compra de bens;
  - Acesso ao WiFi.

services

Serviços (benefícios) disponíveis para troca, para o portador do cartão.

changeableServices

Identificada se um BIN que não teve origem no FLEX, foi migrado para FLEX. 
Se `true`, identifica que foi migrado para o FLEX.
Se `false`, identifica que ainda não foi migrado para o FLEX.

isMigrated

Identificada se um BIN é FLEX ou não. 
Se `true`, identifica que é um bin FLEX.
Se `false`, identifica que ainda não é um BIN Flex.

isFlex

Informações de autorização e liquidação do cartão, para Débito.

authorizationDebit

Informações de autorização do cartão, para Crédito.

authorizationCredit

Identifica se o BIN está habilitado para o processo de autenticação ELO (3DS Elo).
Se `true`, está habilitado.
Se `false`, não está habilitado.

is3DS

currency

Número do Banco liquidante da operação de Débito

Indica qual o código do banco deverá ser utilizado para liquidar
operações de crédito.

**API Privada**

creditSettlementBankNumber

debitSettlementBankNumber

Representa um BIN (_Bank Identification Number_ ou Número de
Identificação do Banco) reservado no sistema.

Este BIN **não** está em uso no momento, porém tem alguns atributos
reconhecidos os quais podem ser utilizados em sistemas antifraudes
ou para provisionamentos diversos.

ReservedBIN

Tabela de BINs.

Tabela de todos os BINs (_Bank Identification Number_ ou Número de
Identificação do Banco) no sistema, tanto os alocados (`bins`)
quanto os reservados (`reserved`).

Os usuários da tabela são sistemas que frequentemente verificam
números de cartão e seus atributos, por exemplo lojas virtuais
(_e-commerce_).

A tabela tem "versão" (`etag`), bem como data e horário da última
modificação, permitindo ao usuário identificar mudanças. Em geral as
tabelas são modificadas semanalmente.

Data e horário da última modificação da tabela.

Pode ser utilizada para identificar que a tabela mudou. Seja
fazendo uma consulta pela data e horário, seja fazendo a consulta
`binTable` e passando a data e horário da última versão conhecida
-- caso a tabela não tenha mudado, nada será retornado.

lastModified

Etiqueta da Entidade (_Entity Tag_).

Similar ao uso em cabeçalhos HTTP, o `ETag` serve como um
identificador que muda quando o conteúdo da tabela muda.

Assim como `lastModified`, pode ser utilizado para identificar
alterações na tabela. Seja consultando pelo novo `etag`, seja
fazendo consulta `binTable` e passando o `etag` anterior -- caso a
tabela não tenha mudado, nada será retornado.

etag

Tamanhos de BIN conhecidos.

A faixa de tamanhos dos números de dígitos que compõe BINs. Ou
seja, ao consultar-se os BINs **não** deve-se fazer com um tamanho
fixo (i.e: 6) e sim todos os tamanhos definidos nesta faixa.

No passado os BINs eram de apenas 4, hoje são de 6 dígitos, porém
o mercado está migrando para até 9 dígitos nos próximos anos. Logo
utilize a quantidade de dígitos parametrizada no seu código!

**Exemplo:** `sizeRange { min: 6, max: 9 }` informa que deve-se
obter prefixos de tamanho 6, 7, 8 e 9 à partir do número do cartão
e então buscá-los na tabela.

sizeRange

bins

Listagem de BINs reservados, porém sem uso.

reserved

Expressão Regular que identifica BINs em uso (alocados).

A expressão regular retornada irá identificar o BIN (`number`) e o
número de dígitos relativos ao `panSizeRange` de cada entrada.

Para comodidade do usuário da expressão regular, um grupo será
retornado para o BIN encontrado. O número do grupo é indefinido
pois vários são utilizados e construídos de forma
automática. Porém um e apenas um grupo é retornado em caso de
sucesso. Veja os exemplos abaixo para mais detalhes.

Por exemplo, considere uma Tabela de BINs com apenas duas entradas
em uso (alocadas):

  - `number: "509069"` com `panSizeRange: { min: 16, max: 16 }`;
  - `number: "12345678"` com `panSizeRange: { min: 17, max: 19}`.

A expressão regular será:
`^(?:(12345678)\d{9,11}|(509069)\d{10})$`.  Caso identifique o BIN
`12345678`, por exemplo o cartão `12345678123456789`, então o
grupo 1 será retornado com o valor `12345678` (BIN). Caso
identifique o BIN `509069`, por exemplo o cartão
`5090691234567890`, então o grupo 2 será retornado com o valor
`509069` (BIN). Caso outro BIN seja passado, ou o número de
dígitos de um cartão não seja correspondente ao `panSizeRange` do
BIN, então nenhum grupo será retornado e a expressão regular não
encontrará nada.

binsRegexp

Expressão Regular que identifica BINs reservados, porém sem uso.

A expressão regular retornada irá identificar o BIN (`number`) e o
número de dígitos relativos ao `panSizeRange` de cada entrada.

Para comodidade do usuário da expressão regular, um grupo será
retornado para o BIN encontrado. O número do grupo é indefinido
pois vários são utilizados e construídos de forma
automática. Porém um e apenas um grupo é retornado em caso de
sucesso. Veja os exemplos abaixo para mais detalhes.

Por exemplo, considere uma Tabela de BINs com apenas duas entradas
reservadas (sem uso):

  - `number: "509069"` com `panSizeRange: { min: 16, max: 16 }`;
  - `number: "12345678"` com `panSizeRange: { min: 17, max: 19}`.

A expressão regular será:
`^(?:(12345678)\d{9,11}|(509069)\d{10})$`.  Caso identifique o BIN
`12345678`, por exemplo o cartão `12345678123456789`, então o
grupo 1 será retornado com o valor `12345678` (BIN). Caso
identifique o BIN `509069`, por exemplo o cartão
`5090691234567890`, então o grupo 2 será retornado com o valor
`509069` (BIN). Caso outro BIN seja passado, ou o número de
dígitos de um cartão não seja correspondente ao `panSizeRange` do
BIN, então nenhum grupo será retornado e a expressão regular não
encontrará nada.

reservedRegexp

Expressão Regular que identifica todos os BINs (alocados e reservados).

A expressão regular retornada irá identificar o BIN (`number`) e o
número de dígitos relativos ao `panSizeRange` de cada entrada.

Para comodidade do usuário da expressão regular, um grupo será
retornado para o BIN encontrado. O número do grupo é indefinido
pois vários são utilizados e construídos de forma
automática. Porém um e apenas um grupo é retornado em caso de
sucesso. Veja os exemplos abaixo para mais detalhes.

Por exemplo, considere uma Tabela de BINs com apenas duas entradas
reservadas (sem uso):

  - `number: "509069"` com `panSizeRange: { min: 16, max: 16 }`;
  - `number: "12345678"` com `panSizeRange: { min: 17, max: 19}`.

A expressão regular será:
`^(?:(12345678)\d{9,11}|(509069)\d{10})$`.  Caso identifique o BIN
`12345678`, por exemplo o cartão `12345678123456789`, então o
grupo 1 será retornado com o valor `12345678` (BIN). Caso
identifique o BIN `509069`, por exemplo o cartão
`5090691234567890`, então o grupo 2 será retornado com o valor
`509069` (BIN). Caso outro BIN seja passado, ou o número de
dígitos de um cartão não seja correspondente ao `panSizeRange` do
BIN, então nenhum grupo será retornado e a expressão regular não
encontrará nada.