A API de Verificação de Conta Credenciadores habilita um mecanismo facilitado e seguro para validar a existência de uma conta cartão do portador ELO.

Verificação de Conta Credenciador

PaymentAccountStatus

VALID

INVALID

NOT_SUPPORTED

ERROR

Tipo de transação solicitada para a validação de conta.

TransactionType

CREDIT

DEBIT

Entrada para `LegalIds`, somente CPF ou CNPJ

cnpj

LegalIdsInputCpfCnpjInput

Identificador Global Único para objeto VerifyPaymentAccount

verifyPaymentAccountId

Documento legal de identificação CPF ou CNPJ.

legalIds

status

BIN (_Bank Identification Number_) do cartão.

O BIN é um prefixo de tamanho variável (em geral entre 6 e 9
dígitos)

type

Identificação do Estabelecimento Comercial cadastrado junto à Elo pelo
Credenciador ou pelo Facilitador no momento do ajuste cadastral do Estabelecimento Comercial.

idCode

Se não-nula, retorna apenas informações à partir (inclusive) da
data e horário dados.
Se `null`, retorna todos os Registros.

startTimestamp

Se não-nula, retorna apenas informações até (inclusive) a data e
horário dados.
Se `null`, retorna todos os registros até o momento atual.

endTimestamp

VerifyPaymentAccountFilterInput

Entrada para as informações do Credenciador

Identificador Global Único do adquirente que submeteu a transação do estabelecimento comercial.
Este campo ajuda no tratamento de problemas fazendo um de/para para o
estabelecimento comercial, especialmente no caso aonde a
descrição do estabelecimento comercial não esta clara. No futuro pode ser utilizado como uma alternativa para descrição do
estabelecimento comercial.

Identificador Global Único do Credenciador junto a Elo.

Este campo identifica unicamente os números designados pela Elo para Estabelecimentos/Credenciador.

code

Identificador Global Único do país onde está localizado o Credenciador.
Transações nacionais utiliza-se o código 076 (Brasil).
[ISO 3166-1 numeric](https://pt.wikipedia.org/wiki/ISO_3166-1_num%C3%A9rico)

countryCode

AcquirerInput

Nome visível publicamente. Normalmente nome bem conhecido, marca, etc.

name

legalName

Descrição da empresa para ser apresentado a usuários.

description

Todos os documentos legais de identificação da empresa.

contact

Endereço postal
* O campo zip deve ser sempre preenchido.

address

Endereço Virtual (Uniform Resource Locator).

Código [ISO18245](https://en.wikipedia.org/wiki/ISO_18245).

Também conhecido como MCC (_Merchant Category Code_), tem 4
dígitos.

Identificador Global Único do país onde está localizado o Merchant, código 076 (Brasil).
[ISO 3166-1 numeric](https://pt.wikipedia.org/wiki/ISO_3166-1_num%C3%A9rico)

MerchantInput

Identificador de cliente opaco, normalmente em formato UUIDv4.

Deve ser usado por clientes para rastrear mutações e respostas,
podendo ser usado pelo servidor para perder requisições duplicadas
devido a falhas de rede e retransmissões.

Compatível com [Relay](https://facebook.github.io/relay/docs/en/mutations.html).

clientMutationId

Documento legal de identificação CPF ou CNPJ

Conteúdo sensível (número do cartão, código de verificação e
validade) o qual foi assinado e então cifrado conforme a estrutura
a seguir.

Estrutura de assinatura e criptografia:

```
JWE.Encrypt(recipient=ServerKey, format=compact,
    JWS.Sign(issuer=UserKey, format=compact,
        JSON.Stringify(CardSensitiveInput)
    )
)
```

Ou seja, os dados conforme o esquema JSON
[CardSensitiveInput](https://github.com/cartaoelo/elo-api-schema/blob/master/schema/CardSensitiveInput.json)
devem ser serializados e então assinados utilizando _JSON Web
Signature_ (JWS) em formato compacto e então cifrados utilizando
_JSON Web Encryption_ (JWE) também em formato compacto. O
resultado final deve ser utilizado como valor deste parâmetro.

O esquema define as seguintes chaves para o objeto de entrada
(`CardSensitiveInput`):

 - `pan`: O número da conta primária (_Primary Account Number_),
   também conhecido como \"número do cartão\" físico. Exemplo:
   `"1234567890123456"`
 - `expiry`: Data de validade do cartão, ou seja, quando ele
   expira. É um objeto composto pelas chaves `month` e `year`
   descritas a seguir. Exemplo: `{"month": 2, "year": 2020}`
     - `month`: Mês da validade do cartão. Número inteiro entre 1
       (Janeiro) e 12 (Dezembro).
     - `year`: Ano da validade do cartão. Número inteiro com 4
       dígitos (2017, não 17).
 - `name`: Nome do portador do cartão. Exemplo: `"João da Silva"`.

A autorização é feita com os campos `csc` ou `authCode` e seus
respectivos horários de entrada. Note que apenas um deles deve ser
especificado:

O número do cartão (`pan`) será utilizado para descoberta dos
demais campos do cartão, como `availableServices`, `bin`,
`funding`, `product`, `isInternational`, `isCompany`, `isToken`,
`brand`, `allowedCaptures`, `usages`, `network`, `issuer` e
`metadata`.

sensitive

acquirer

Informações do Comerciante.
Possui campos como razão social, nome fantasia, documentos legais (CNPJ) e categorias (MCC).

merchant

VerifyPaymentAccountInput

input

Mutation responsável por realizar a verificação de conta de um cartão junto ao Emissor(CardIssuer).

verifyPaymentAccount

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

_Query_ (consulta) de verificação de conta de um cartão junto ao Emissor `CardIssuer`

verifyPaymentAccounts

`PageInfo` compatível com [Relay](https://facebook.github.io/relay/docs/en/mutations.html).

hasPreviousPage

hasNextPage

startCursor

endCursor

PageInfo

Aresta de conexão contendo dados de verificação de conta em conformidade com o
[Relay](https://facebook.github.io/relay/docs/en/mutations.html).

Cursor opaco para ser usado com _queries_ (consultas) `after` ou
`before`.

cursor

O objeto de verificação de conta que compõe essa aresta de conexão.

node

VerifyPaymentAccountsEdge

Conexão de verificação de conta em conformidade com o
[Relay](https://facebook.github.io/relay/docs/en/mutations.html).

pageInfo

Lista de arestas que compõem esta conexão.

edges

Contagem total de objetos nesta conexão.

Arestas são limitadas a cursores `before` e `after`, assim como
primeiras e últimas contagens. Assim o tamanho de arestas é possivelmente
menor que a conexão como um todo.

`totalCount`, se não for `null`, indica o número total de itens na conexão
considerando-se o filtro.

totalCount

VerifyPaymentAccountsConnection

Dado da solicitação de validação de conta.

Data que a validação de conta foi realizada.

verifiedAt

VerifyPaymentAccount

Retorno da mutação `verifyPaymentAccount()`.

Compatível com [Relay](https://facebook.github.io/relay/docs/en/mutations.html).