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

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

`POST /api/PagueContas/ConsultaCartaoTitular`

## Request

- Base URL: `https://pagamentos.meuk8.com.br/PagamentosAPI`
- URL: `https://pagamentos.meuk8.com.br/PagamentosAPI/api/PagueContas/ConsultaCartaoTitular`
- Auth: OAuth 2
  - Password
  - Token URL: `/BknBankPagamentosAPI/token` scopes: `BknBankPagamentosAPI`

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.
Também disponibiliza a possibilidade da criação de uma transação de desafio para validação do cartão por meio da confirmação de um valor aleatório.

### 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 | Boleano | Informa True ou false, para indicar se o e-mail consultado foi verificado | Não |
| SessaoID | Texto | Identificador da Sessão | Não |
| **DadosConsultadoEndereco** | **ConsultaCartaoTitularEndereco** | **Não** |
| CEP | Texto | CEP do Consultado | Não (1) |
| Endereco | Texto| Logradouro do Consultado | Não (1) |
| Numero | Texto | Número do endereço do Consultado | Não (1) |
| Complemento | Texto | Complemento do Consultado | Não (1) |
| Bairro | Texto | Bairro do endereço do Consultado | Não (1) |
| Cidade | Texto | Cidade do endereço do Consultado | Não (1) |
| UF | Texto | UF do endereço do Consultado | Não (1) |
| Pais | Texto | Pais do endereço do Consultado | Não (1) |
|--|--|--|--|
| **DadosConsultadoTelefone** | **ConsultaCartaoTitularTelefone** | **Sim** |
| 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 | Número | Número de telefone do Consultado | Sim |
| TelefoneVerificado | Boleano | Informa True ou false, para indicar se o número de telefone consultado foi verificado | Não |
|--|--|--|--|
| **DadosConsultadoCartao** | **ConsultaCartaoTitularCartaoDados** | **Sim** |
| NomeImpresso  (Obrigatório) | Texto | Nome do titular do cartão | Sim |
| NumeroCartao (Obrigatório) | 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(2) |
| CodigoSeguranca | Numérico de 3 posições | Código de segurança no verso do cartão | Não(2) |
| TitularCPFCNPJ | Texto | CPF/ CNPJ do titular do cartão | Não(2) |
|--|--|--|--|
| 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 |
| HabilitarDesafio | Boleano | Indica se deve ser gerada uma transção com valor aleatório para validação do cartão | Não |
<br /> 

(1) - Obrigatório se **DadosConsultadoEndereco** for informado
(2) - Obrigatório se **HabilitarDesafio = true** 
### Resposta
| **Campo** | **Tipo** | **Descrição** | 
|--|--|--| 
| ID | Texto | 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 |
| CardToken | Texto | Identificador do token gerado para o cartão |
| IdentificadorDesafio | Texto | Identificador do desafio gerado |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessConsultaCartaoTitularPagueContasRequest
  - `HabilitarDesafio` boolean
  - `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`

Consulta Cartao Titular

- BknBankPagamentosBusinessConsultaCartaoTitularPagueContasResponse
  - `CardToken` string, uuid
  - `IdentificadorDesafio` string, uuid
  - `Id` string, uuid
  - `Resultado` string
  - `ErroTititulo` string
  - `ErroInstancia` string
  - `ErroDetalhe` string
  - `ErroTipo` string

## Other responses

- `400`: Requisição inválida

## Changes

- **2026-11-03** `a8b4ea0aa298`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/meuk8/apis/k8-fintech/changes/api/PagueContas/ConsultaCartaoTitular/post.md)

---

[API](https://skmtc.dev/meuk8/apis/k8-fintech.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-fintech/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-fintech/revisions/a8b4ea0aa298?raw)