Autentica Titular Cartão

A API Autentica Titular Cartão possibilita ao cliente validar a autenticidade dos dados de cadastro de seus consumidores possibilitando a melhoria operacional e prevenção à fraude em processos de Onboarding e transacional onde são utilizados cartões de credito. Para a consulta o cliente realiza o envio das informações de input e recebe online o retorno da consulta com uma "Score" e uma "Flag" indicando as condições aplicadas para cálculo da nota. <Note> Indicada para validação de titularidade de cartão em processos de onboarding financeiro, prevenção a fraudes em transações com cartão de crédito, e verificação da correspondência entre CPF, BIN e últimos dígitos informados pelo cliente. </Note> ## TABELA DE CAMPOS DE REQUISIÇÃO | **Campo** | **Descrição** | **Formato** | **Obrigatório** | |-----------|---------------|-------------|-----------------| | **IdConsulta** | Identificador da consulta. Valor fixo: `506`. | string | Sim | | **CpfCnpj** | CPF do titular a ser validado. | string | Sim | | **NumeroCartao** | Últimos 4 dígitos do cartão de crédito. | string | Sim | | **CCBIN** | BIN (primeiros 6 dígitos) do cartão de crédito. | string | Sim | ## TABELA DE CAMPOS DE RETORNO <AccordionGroup> <Accordion title="Cabeçalho da Resposta — CONSULTA"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **CONSULTA.CODIGORESPOSTA** | Código interno de resposta gerado pela Credify. | string | | **CONSULTA.DATAHORA** | Data e hora da consulta no formato DD/MM/AAAA HH:MM:SS. | string | | **CONSULTA.LOGON** | Identificador do usuário que realizou a consulta. | string | | **CONSULTA.IDCONSULTA** | Identificador da consulta enviado na requisição. | string | | **RESPOSTA.CODIGO** | Código de status da resposta (`1` = sucesso, `2` = não encontrado, `3` = erro). | string | </Accordion> <Accordion title="🔐 Status da Transação — HEADER"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.AUTENTICATITULARCARTAO.AUTHCCSCORERESPONSEEX.RESPONSE.HEADER.STATUS** | Código de status da verificação (`0` = sucesso). | string | | **RESPOSTA.AUTENTICATITULARCARTAO.AUTHCCSCORERESPONSEEX.RESPONSE.HEADER.TRANSACTIONID** | Identificador único da transação. | string | </Accordion> <Accordion title="💳 Resultado da Autenticação — REGISTRO_0"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **RESPOSTA.AUTENTICATITULARCARTAO.AUTHCCSCORERESPONSEEX.RESPONSE.RECORDS.AUTHCCSCOREOUTPUT.REGISTRO_0.CPF** | CPF consultado para validação de titularidade. | string | | **RESPOSTA.AUTENTICATITULARCARTAO.AUTHCCSCORERESPONSEEX.RESPONSE.RECORDS.AUTHCCSCOREOUTPUT.REGISTRO_0.CREDITCARDOWNERSHIP** | Indicador de titularidade (`0` = não é titular de nenhum cartão conhecido). | string | </Accordion> <Accordion title="📋 Código de Retorno — REASONCODE"> | **Campo** | **Descrição** | **Formato** | |:----------|:--------------|:------------| | **REASONCODE.REGISTRO_0.CODE** | Código da justificativa para o resultado. | string | | **REASONCODE.REGISTRO_0.MESSAGE** | Mensagem explicativa sobre a correspondência ou não dos dados consultados. | string | </Accordion> </AccordionGroup> ## INFORMAÇÕES COMPLEMENTARES <AccordionGroup> <Accordion title="Tabela de REASONCODE"> | **Código** | **Mensagem** | |:-----------|:-------------| | `0.1` | Não houve match entre o CPF e os últimos 4 dígitos do cartão informado. No entanto, o CPF está em nossa base vinculado a outros cartões conhecidos. | | `0.2` | O CPF não foi encontrado em nossa base de cartões de crédito. | | `0.3` | Não houve match entre o CPF e os últimos 4 dígitos do cartão informado. No entanto, o CPF está em nossa base vinculado a outros cartões conhecidos e desconhecidos. | | `0.4` | Não houve match entre o CPF e os últimos 4 dígitos do cartão informado. No entanto, o CPF está em nossa base vinculado a outros cartões desconhecidos. | | `0.5` | O CPF foi encontrado na nossa base de cartões e possui match com os últimos 4 dígitos do cartão informado. No entanto, o BIN não corresponde ao da instituição a qual houve match. | | `1.1` | O CPF foi encontrado na nossa base de cartões e possui match dos últimos 4 dígitos do cartão e BIN informados. | | `1.2` | O CPF foi encontrado na nossa base de cartões sem match com os últimos 4 dígitos do cartão informado. No entanto, houve match entre o CPF e a Instituição Financeira vinculada ao BIN. | | `100` | CPF possui menos de 18 anos. | | `150` | CPF solicitou que seus dados não sejam compartilhados com o mercado. | | `200` | CPF consta como óbito na base de dados da Credify. | </Accordion> </AccordionGroup>