---
title: "Analisa a titularidade de um cartão de crédito"
method: POST
path: "/api/ConsultaCartaoTitular"
tags: ["ConsultaCartaoTitular"]
---

# Analisa a titularidade de um cartão de crédito

`POST /api/ConsultaCartaoTitular`

O endpoint oferece uma avaliação da titularidade do cartão de crédito consultado. Dentro dos retornos desse módulo são apresentadas as informações da restrição para continuidade da operação.
<br /> 

### Requisição 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** | 
|--|--|--|--| 
| ConsultadoTipo | Texto | Indica se a consulta será através do CPF ou CNPJ | Sim |
| ConsultadoCPFCNPJ | Texto | CPF ou CNPJ consultado | Sim |
| ConsultadoNome | Texto | Nome completo do consultado (sem abreviações) | Não |
| ConsultadoDataNascimento | Texto | Data de nascimento do consultado | Não |
| ConsultadoEmail | Texto | E-mail do consultado | Não |
| ConsultadoNomeMae | Texto | Nome da mãe do consultado | Não |
| EmailVerificado | Booleano | Informa True ou false, para indicar se o e-mail consultado foi verificado | Não |
| SessaoID | GUID | Identificador da Sessão | Não |
| **DadosConsultadoEndereco** | **ConsultaCartaoTitularEndereco** | **-** |
| CEP | Texto | CEP do Consultado | Não |
| Endereco | Texto| Logradouro do Consultado | Não |
| Numero | Texto | Número do endereço do Consultado | Não |
| Complemento | Texto | Complemento do Consultado | Não |
| Bairro | Texto | Bairro do endereço do Consultado | Não |
| Cidade | Texto | Cidade do endereço do Consultado | Não |
| UF | Texto | UF do endereço do Consultado | Não |
| País | Texto | País do endereço do Consultado | Não |
| **DadosConsultadoTelefone** | **ConsultaCartaoTitularTelefone** | **-** |
| DDI | Número | Indica o país do telefone do Consultado (Ex: 55) | Sim |
| DDD | Número |Indica o estado do telefone do Consultado (Ex: 41)  | Sim |
| Numero (Obrigatório) | Número | Número de telefone do Consultado | Sim |
| TelefoneVerificado | Booleano | Informa True ou false, para indicar se o número de telefone consultado foi verificado | Não |
| **DadosConsultadoCartao** | **ConsultaCartaoTitularCartaoDados** | **-** |
| NomeImpresso  | Texto | Nome do titular do cartão | Sim |
| NumeroCartao | Numérico de 16 posições | Número do cartão | Sim |
| DataValidade | Ano/Mês no formato AAAAMM | Data de validade do cartão | Não |
| CodigoSeguranca | Numérico de 3 posições | Código de segurança no verso do cartão | Não |
| TitularCPFCNPJ | Texto | CPF/ CNPJ do titular do cartão | Não |
| ConsultadoTipoAdicional | Texto | Opção complemento dos dados do consultado, podendo ser CPF ou CNPJ | Não |
| ConsultadoCPFCNPJAdicional | Texto | CPF ou CNPJ do consultado | Não |
| TransacaoData | Texto | Data da transação | Não |
| TransacaoTipo | Texto | Indicar se a transação foi realizada Presencial ou Online | Não |
<br /> 

### Resposta
| **Campo** | **Tipo** | **Descrição** | 
|--|--|--| 
| ID | Guid | ID da consulta |
| Resultado | Texto | Resultado da consulta, sendo com ou sem restrição |
| ErroTitulo | Texto | Título das ocorrências, em casos de erro |
| ErroInstancia | Texto | Em qual parte do processo ocorreu o erro |
| ErroDetalhe | Texto | Detalhes do erro |
| ErroTipo | Texto | Tipo do erro |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessConsultaCartaoTitularRequest
  - `ConsultadoTipo` string, required
  - `ConsultadoCPFCNPJ` string, required
  - `ConsultadoNome` string
  - `ConsultadoDataNascimento` string, date-time
  - `ConsultadoEmail` string
  - `ConsultadoNomeMae` string
  - `EmailVerificado` boolean
  - `SessaoId` string
  - `DadosConsultadoEndereco` BknBankPagamentosBusinessConsultaCartaoTitularEndereco
    - `CEP` string
    - `Endereco` string
    - `Numero` string
    - `Complemento` string
    - `Bairro` string
    - `Cidade` string
    - `UF` string
    - `Pais` string
  - `DadosConsultadoTelefone` BknBankPagamentosBusinessConsultaCartaoTitularTelefone, required
    - `DDI` integer, required
    - `DDD` integer, required
    - `Numero` integer, required
    - `TelefoneVerificado` boolean
  - `DadosConsultadoCartao` BknBankPagamentosBusinessConsultaCartaoTitularCartaoDados, required
    - `NomeImpresso` string, required
    - `NumeroCartao` string, required
    - `DataValidade` string
    - `CodigoSeguranca` string
    - `TitularCPFCNPJ` string
  - `ConsultadoTipoAdicional` string
  - `ConsultadoCPFCNPJAdicional` string
  - `TransacaoData` string, date-time
  - `TransacaoTipo` 'Presencial' | 'Online'

## Response `200`

ConsultaCartaoTitular

- BknBankPagamentosBusinessConsultaCartaoTitularResponse
  - `Id` string, uuid
  - `Resultado` string
  - `ErroTititulo` string
  - `ErroInstancia` string
  - `ErroDetalhe` string
  - `ErroTipo` string

## Other responses

- `500` — Erro executando método

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)