ConsultaCartaoTitular

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

Changed on

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

CampoTipoDescriçãoObrigatório
ConsultadoTipoTextoIndica se a consulta será através do CPF ou CNPJSim
ConsultadoCPFCNPJTextoCPF ou CNPJ consultadoSim
ConsultadoNomeTextoNome completo do consultado (sem abreviações)Não
ConsultadoDataNascimentoDataData de nascimento do consultadoNão
ConsultadoEmailTextoE-mail do consultadoNão
ConsultadoNomeMaeTextoNome da mãe do consultadoNão
EmailVerificadoBooleanoInforma true ou false, para indicar se o e-mail consultado foi verificadoNão
SessaoIdTextoIdentificador da sessãoNão
DadosConsultadoEnderecoConsultaCartaoTitularEndereco-Não
CEPTextoCEP do consultadoNão
EnderecoTextoLogradouro do consultadoNão
NumeroTextoNúmero do endereço do consultadoNão
ComplementoTextoComplemento do consultadoNão
BairroTextoBairro do endereço do consultadoNão
CidadeTextoCidade do endereço do consultadoNão
UFTextoUF do endereço do consultadoNão
PaísTextoPaís do endereço do consultadoNão
DadosConsultadoTelefoneConsultaCartaoTitularTelefone-Sim
DDINúmeroIndica o país do telefone do consultado (Ex: 55)Sim
DDDNúmeroIndica o estado do telefone do consultado (Ex: 41)Sim
NumeroNúmeroNúmero de telefone do consultadoSim
TelefoneVerificadoBooleanoInforma true ou false, para indicar se o número de telefone consultado foi verificadoNão
DadosConsultadoCartaoConsultaCartaoTitularCartaoDados-Sim
NomeImpressoTextoNome do titular do cartãoSim
NumeroCartaoTextoNúmero do cartãoSim
DataValidadeDataData de validade do cartãoNão
CodigoSegurancaTextoCódigo de segurança no verso do cartãoNão
TitularCPFCNPJTextoCPF/ CNPJ do titular do cartãoNão
ConsultadoTipoAdicionalTextoOpção complemento dos dados do consultado, podendo ser CPF ou CNPJNão
ConsultadoCPFCNPJAdicionalTextoCPF ou CNPJ do consultadoNão
TransacaoDataDataData da transaçãoNão
TransacaoTipoTextoIndicar se a transação foi realizada Presencial ou OnlineNão

Resposta

CampoTipoDescrição
IdGUIDIdentificador da consulta
ResultadoTextoResultado da consulta, sendo com ou sem restrição
ErroTitituloTextoTítulo das ocorrências em casos de erro
ErroInstanciaTextoEm qual parte do processo ocorreu o erro
ErroDetalheTextoDetalhes do erro
ErroTipoTextoTipo do erro
post/api/ConsultaCartaoTitular

Request

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

Headers

Aeskeystring required

Request body

ConsultadoTipostring required
ConsultadoCPFCNPJstring required
ConsultadoNomestring
ConsultadoDataNascimentostring date-time
ConsultadoEmailstring
ConsultadoNomeMaestring
EmailVerificadoboolean
SessaoIdstring
ConsultadoTipoAdicionalstring
ConsultadoCPFCNPJAdicionalstring
TransacaoDatastring date-time
TransacaoTipo'Presencial' | 'Online'

Example request

{
  "ConsultadoTipo": "CPF",
  "ConsultadoCPFCNPJ": "48455151480",
  "ConsultadoNome": "Renato Samuel Augusto Baptista",
  "ConsultadoDataNascimento": "1987-02-13T00:00:00",
  "ConsultadoEmail": "renatosamuel@umdominio.com.br",
  "ConsultadoNomeMae": "Renato Samuel Augusto Baptista",
  "EmailVerificado": false,
  "SessaoId": "68c998f6-868a-4523-b645-e5879480fda0",
  "DadosConsultadoEndereco": {
    "CEP": "82510290",
    "Endereco": "Rua Canadá, 257",
    "Numero": "13",
    "Complemento": "Ap 16",
    "Bairro": "Bacacheri",
    "Cidade": "Curitiba",
    "UF": "PR",
    "Pais": "Brasil"
  },
  "DadosConsultadoTelefone": {
    "DDI": 55,
    "DDD": 41,
    "Numero": 999293802,
    "TelefoneVerificado": false
  },
  "DadosConsultadoCartao": {
    "NomeImpresso": "Renato Samuel Augusto Baptista",
    "NumeroCartao": "4024007105862618",
    "DataValidade": "203008",
    "CodigoSeguranca": "1234",
    "TitularCPFCNPJ": "48455151480"
  },
  "ConsultadoTipoAdicional": "CNPJ",
  "ConsultadoCPFCNPJAdicional": "72264224000111",
  "TransacaoData": "2026-08-19T10:15:28.5581745-03:00",
  "TransacaoTipo": "Presencial"
}

Response

Consulta de titularidade realizada com sucesso

Idstring uuid
Resultadostring
ErroTititulostring
ErroInstanciastring
ErroDetalhestring
ErroTipostring

Example response

{
  "Id": "00000000-0000-0000-0000-000000000000"
}

Changes

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/xml for the response with the status

    • info

      added the media type text/json for the response with the status

    • info

      added the media type text/xml for the response with the status

    • info

      added the non-success response with the status