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.

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.

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

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

🔐 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

💳 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

📋 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

INFORMAÇÕES COMPLEMENTARES

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Objeto de consulta com CPF, últimos 4 dígitos do cartão e BIN.

ConsultaobjectRequired

Response

Resposta da consulta:

Código 1: Sucesso.
Código 2: Dado não encontrado na base de dados.
Código 3: Erro na consulta.

CONSULTAobjectOptional

RESPOSTAobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error