---
title: "Antifraude"
method: POST
path: "/api/antifraude/incluir"
tags: ["AntiFraude"]
---

# Antifraude

`POST /api/antifraude/incluir`

As APIs de pagamentos antifraude funcionam como um intermediário entre o sistema de pagamento da loja e uma solução antifraude especializada. As lojas coletam dados da transação, como valor, endereço de entrega, dados do cartão, e os enviam para a solução antifraude para análise.
Com base na análise, a solução antifraude envia uma resposta, indicando se a transação deve ser aprovada ou recusada.

### Requisição 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--|
| Identificador | GUID | Identificador da transação de cartão de crédito que esta Pendente de Análise de Antifraude | Sim |
| IdentificadorSessao | GUID |Informe o campo IdentificadorSessao. O mesmo utilizado no envio do Finger Print | Sim |
| TipoEcommerce | Texto | B2B/B2C | Não |
| ClienteIP | Texto | IP do cliente final da transação | Não | 
| MensagemParaPresente | Texto | Mensagem de presente informada pelo comprador | Não |
| Observação | Texto | Observações referente ao pedido | Não |
| OrigemPedido | Texto | Origem do Pedido | Não |
| OrigemComplementar | Texto | ID do canal | Não |
| DataReservaVoo | Texto | Data de reserva do voo | Não | 
| IdentificadorProduto | Número | Identificador do tipo de análise realizado | Não |
| DadosCobranca | DadosCobranca | Dados do comprador | Sim |
| DadosEntrega | DadosEntrega | Dados da entrega | Não |
| DadosPagamentos| Array[DadosPagamentos] | Informação dos dados de pagamentos | Sim |
| ProdutosServicos | Array[ProdutosServicos] | Dados dos produtos e serviços adquiridos | Sim |
| Passageiros | Array[Passageiros] | Dados do(s) passageiro(s) | Não |
| ConexoesAereas | Array[ConexoesAereas] | Dados das conexões da passagem comprada | Não |
| **DadosCobranca** | **-** | **-** | **-** | 
| CodigoCliente | Texto | Identificador do cliente | Não |
| TipoCliente | Texto | Opção do tipo do cliente, sendo pessoa física ou Jurídica[CPF ou CNPJ] | Sim |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim |
| ClienteRGIE | Texto | RG ou Inscrição estadual (IE) do cliente final | Não |
| ClienteNome | Texto| Nome do cliente final da transação | Sim |
| ClienteDataNascimento | Texto | Data de nascimento do cliente | Não |
| ClienteEmail | Texto | E-mail do cliente final da transação | Não |
| ClienteSexo | Texto | Sexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) | Não |
| DadosEndereco | DadosEndereco | Dados do Endereço | Não |
| Telefones | Array[Telefone] | Dados do telefone do cliente | Não |
| **DadosEntrega** | **-** | **-** | **-** |
| CodigoCliente | Texto | Código de identificação do cliente final | Não |
| TipoCliente | Texto | Opção do tipo do cliente, sendo pessoa física ou Jurídica[CPF ou CNPJ] | Não |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final da transação | Sim |
| ClienteRGIE | Texto | RG ou Inscrição estadual (IE) do cliente final | Não |
| ClienteNome | Texto | Nome do cliente final da transação | Não |
| ClienteDataNascimento | Texto | Data de nascimento do cliente | Não |
| ClienteEmail | Texto | E-mail do cliente final da transação | Não |
| ClienteSexo | Texto | Sexo do cliente final da compra, podendo ser M (masculino) ou F (feminino) | Não |
| DadosEndereco | Texto | Dados do Endereço | Não |
| Telefones | Array[Telefone] | Dados do telefone do cliente | Não |
| ProdutosServicos | Array[ProdutosServicos] | Descrição dos produtos e serviços adquiridos | Não |
| PrazoEntrega | Texto | Prazo da entrega previsto do produto | Não |
| ValorFrete | Número | Valor do frete da entrega | Não |
| **DadosPagamento** | **-** |**-**  | **-** |
| NumeroSequencial | Número |Sequência de realização do pagamento | Não |
| DataPagamento | Texto | Data da efetivação do pagamento | Não |
| ValorPago | Numérico com 2 decimais | Valor pago da transação | Sim |
| TipoPagamento | Número | 1 (Cartão de crédito) | Sim |
| QuantidadeParcelas | Numérico Inteiro | Quantidade de parcelas, caso a forma de pagamento seja parcelada.Válidos valores de 2 até 12. Caso seja a vista, pode-se não enviar o valor ou enviar 1 | Não |
| Cartao | Cartão | Dados do Cartão | Sim | 
| **ProdutoServico** | **-** | **-**| **-** |
| CodigoProdutoServico | Texto | Código identificador do Produto ou Serviço | Não |
| NomeProdutoServico | Texto | Nome do produto ou descrição do serviço | Sim |
| ValorProdutoServico | Número | Valor do produto ou serviço | Não |
| QuantidadeProdutoServico | Número | Quantidade do produto ou serviço | Não |
| CodCategoriaProdutoServico | Número| Código para identificar a categoria do produto ou serviço | Não |
| NomeCategoriaProdutoServico | Texto | Nome para identificar a categoria do produto ou serviço | Não |
| NomeVendedorProdutoServico | Texto | Nome do vendedor | Não |
| VendedorProdutoServicoCPFCNPJ | Texto | CPF ou CNPJ do vendedor | Não |
| MarketPlace | Booleano | True ou False para informar se o vendedor é marketplace | Não |
| VendedorProdutoServicoSegmento | Texto | Area de atuação do vendedor | Não |
| **Passageiro** | **-** | **-** | **-** |
| NomePassageiro | Texto | Nome do passageiro |  
| CompanhiaDeMilhagem | Texto | Companhia na qual é acumulado Milhagem | Não |
| CartaoDeMilhagem | Texto | Número do cartão de Milhagem | Não |
| TipoIdentificacao | Texto | Documento de identificação do passageiro, podendo ser: CPF, CNPJ, RG, IE, Passaporte, CTPS, Titulo Eleitor | Não |
| NumeroIdentificacao| Texto | Número de identificação do passageiro, conforme tipo de identificação selecionado | Não |
| PassageiroSexo | Texto | Sexo do passageiro, podendo ser M (masculino) ou F (feminino) | Não |
| PassageiroDataNascimento| Texto | Data de nascimento do passageiro | Não |
| PassageiroCPF | Texto | CPF do Passageiro | Não |
| **ConexaoAerea** | **-** | **-** | **-** |
| CompanhiaAerea | Texto | Companhia aérea do voo | Não |
| NumeroViagem | Número | Número da viagem do voo | Não |
| DataViagem | Data/hora |Data/hora da viagem | Não |
| ClasseAssento | Texto | Classe e Assento da passagem | Não |
| OrigemViagem | Texto | O local de origem da viagem | Não |
| DestinoViagem | Texto | O local de destino da viagem | Não |
| DataEmbarque| Texto | Data de embarque do voo | Não |
| DataDesembarque | Texto | Data de desembarque do voo | Não |
| ClasseTarifaria | Texto| Classe tarifária da passagem | Não |
| **DadosEndereco** | **-** | **-** | **-** |
| ClienteEndereco | Texto | Nome do logradouro | Não |
| ClienteNumero | Texto | Número do endereço do cliente final da compra | Não |
| ClienteComplemento | Texto | Complemento do endereço do cliente final da compra | Não |
| ClienteBairro | Texto | Bairro do cliente final da compra | Não |
| ClienteCidade | Texto | Cidade do cliente final da compra | Não |
| ClienteUF | Texto | UF do cliente final da compra | Sim |
| ClienteCEP | Texto | CEP do cliente final da compra | Sim |
| ClientePais | Texto | País do cliente final da compra | Sim |
| ClientePontoDeReferencia | Texto | Ponto de referência da localização do cliente final da compra | Não |
| **Telefone** | **-** |**-** | **-** |
| TelefoneTipo | Texto | Tipo de telefone | Não |
| DDI | Número |DDI do telefone do cliente final da compra | Não |
| DDD | Número | DDD do telefone do cliente final da compra | Não |
| TelefoneNumero | Número | Número do telefone do cliente final da transação | Não |
| TelefoneRamal | Texto | Número do ramal do cliente final da transação | Não |
| **Cartao** | **-** | **-** |**-** | 
| NumeroCartao | Numérico de 16 posições | Número do Cartão | Não |
| CardToken | GUID | Código identificador do token do cartão | Não |
| Bin |Texto  | 6 primeiros números do cartão de crédito | Sim |
| End | Texto | 4 últimos números do cartão de crédito | Sim |
| Bandeira | Texto | Bandeira do cartão | Não |
| DataValidade | Ano/Mês no formato AAAAMM| Data de validade do cartão | Não |
| NomeImpresso | Texto | Nome do cliente impresso no cartão | Não |
| ClienteCPFCNPJ | Texto | CPF/CNPJ do cliente final do proprietário do cartão | Sim |
| NsuOperacao | Texto | Número de identificador único de uma transação de cartão | Não | 
            
 ### Resposta
 | **Campo** | **Tipo** | **Descrição** | 
 |--|--|--| 
 |Retorno | Texto | Retorno da chamada, podendo possuir os valores OK ou ERRO |  
 |Detalhes | Texto | Detalhes do erro gerado, caso o retorno seja ERRO |  
 |Identificador  | Texto | Detalhes do erro gerado, caso o retorno seja ERRO |  
 |Status | Texto | Status é o resultada da análise, podendo ser: APA: (Aprovação Automática) – Pedido foi aprovado automaticamente segundo parâmetros definidos na regra de aprovação automática. RPA: (Reprovação Automática) – Pedido Reprovado Automaticamente por algum tipo de Regra de Negócio que necessite aplicá-la. RPP: (Reprovação Por Política) – Pedido reprovado automaticamente por política estabelecida pelo cliente ou Clearsale. APP: (Aprovação Por Política) – Pedido aprovado automaticamente por política estabelecida pelo cliente ou Clearsale |  
 |Score | Número | Score é um valor de 0 a 100 atribuído a consulta que avalia o nível de risco de fraude de identidade  |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessTransacaoAntifraudeRequest
  - `Identificador` string, required
  - `IdentificadorSessao` string, required
  - `TipoEcommerce` string
  - `ClienteIP` string
  - `MensagemParaPresente` string
  - `Observacao` string
  - `OrigemPedido` string
  - `OrigemComplementar` string
  - `DataReservaVoo` string, date-time
  - `IdentificadorProduto` integer
  - `DadosCobranca` BknBankPagamentosBusinessDadosCobranca, required
    - `CodigoCliente` string
    - `TipoCliente` 'CPF' | 'CNPJ', required
    - `ClienteCPFCNPJ` string, required
    - `ClienteRGIE` string
    - `ClienteNome` string, required
    - `ClienteDataNascimento` string, date-time
    - `ClienteEmail` string
    - `ClienteSexo` string
    - `DadosEndereco` BknBankPagamentosBusinessDadosEndereco, required
      - `ClienteEndereco` string, required
      - `ClienteNumero` string, required
      - `ClienteComplemento` string
      - `ClienteBairro` string, required
      - `ClienteCidade` string, required
      - `ClienteUF` string, required
      - `ClienteCEP` string, required
      - `ClientePais` string
      - `ClientePontoDeReferencia` string
    - `Telefones` BknBankPagamentosBusinessTelefone[], required
      - `TelefoneTipo` 'NaoDefinido' | 'Residencial' | 'Comercial' | 'Recados' | 'Cobranca' | 'Temporario' | 'Celular'
      - `DDI` integer
      - `DDD` integer
      - `TelefoneNumero` integer
      - `TelefoneRamal` string
  - `DadosEntrega` BknBankPagamentosBusinessDadosEntrega
    - `CodigoCliente` string
    - `TipoCliente` 'CPF' | 'CNPJ', required
    - `ClienteCPFCNPJ` string, required
    - `ClienteRGIE` string
    - `ClienteNome` string, required
    - `ClienteDataNascimento` string, date-time
    - `ClienteEmail` string
    - `ClienteSexo` string
    - `DadosEndereco` BknBankPagamentosBusinessDadosEndereco
      - `ClienteEndereco` string, required
      - `ClienteNumero` string, required
      - `ClienteComplemento` string
      - `ClienteBairro` string, required
      - `ClienteCidade` string, required
      - `ClienteUF` string, required
      - `ClienteCEP` string, required
      - `ClientePais` string
      - `ClientePontoDeReferencia` string
    - `Telefones` BknBankPagamentosBusinessTelefone[], required
      - `TelefoneTipo` 'NaoDefinido' | 'Residencial' | 'Comercial' | 'Recados' | 'Cobranca' | 'Temporario' | 'Celular'
      - `DDI` integer
      - `DDD` integer
      - `TelefoneNumero` integer
      - `TelefoneRamal` string
    - `PrazoEntrega` string
    - `ValorFrete` number, double
  - `DadosPagamentos` BknBankPagamentosBusinessDadosPagamento[], required
    - `NumeroSequencial` integer
    - `DataPagamento` string, date-time
    - `ValorPago` number, double
    - `TipoPagamento` integer, required
    - `QuantidadeParcelas` integer
    - `Cartao` BknBankPagamentosBusinessCartao, required
      - `NumeroCartao` string
      - `CardToken` string
      - `Bin` string, required
      - `End` string, required
      - `Bandeira` 'Diners' | 'MasterCard' | 'Visa' | 'Outros' | 'AmericanExpress' | 'HiperCard' | 'Aura' | 'Elo'
      - `DataValidade` string
      - `NomeImpresso` string
      - `ClienteCPFCNPJ` string
      - `NsuOperacao` string
  - `ProdutosServicos` BknBankPagamentosBusinessProdutoServico[], required
    - `CodigoProdutoServico` string
    - `NomeProdutoServico` string, required
    - `ValorProdutoServico` number, double
    - `QuantidadeProdutoServico` integer
    - `CodCategoriaProdutoServico` integer
    - `NomeCategoriaProdutoServico` string
    - `NomeVendedorProdutoServico` string
    - `VendedorProdutoServicoCPFCNPJ` string
    - `MarketPlace` boolean
    - `VendedorProdutoServicoSegmento` string
  - `Passageiros` BknBankPagamentosBusinessPassageiro[]
    - `NomePassageiro` string
    - `CompanhiaDeMilhagem` string
    - `CartaoDeMilhagem` string
    - `TipoIdentificacao` 'CPF' | 'CNPJ' | 'RG' | 'IE' | 'Passaporte' | 'CTPS' | 'TituloEleitor'
    - `NumeroIdentificacao` string
    - `PassageiroSexo` string
    - `PassageiroDataNascimento` string, date-time
    - `PassageiroCPF` string
  - `ConexoesAereas` BknBankPagamentosBusinessConexaoAerea[]
    - `CompanhiaAerea` string
    - `NumeroViagem` integer
    - `DataViagem` string, date-time
    - `ClasseAssento` string
    - `OrigemViagem` string
    - `DestinoViagem` string
    - `DataEmbarque` string, date-time
    - `DataDesembarque` string, date-time
    - `ClasseTarifaria` string

## Response `200`

Incluir Antifraude da Transacao

- BknBankPagamentosBusinessTransacaoAntifraudeResponse
  - `Retorno` 'OK' | 'ERRO'
  - `Detalhes` string
  - `Identificador` string
  - `Status` string
  - `Score` number, double

## 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)