> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-creation.md).
# Criação de fraude suspeita
{% hint style="info" %}
**Requisitos de autenticação:**
* Os endpoints regulares usam `OAuth2` autenticação com a URL base: `https://api.us.prd.caf.io`
* Para maior segurança, alguns endpoints também podem oferecer suporte a `mTLS` autenticação com a URL base: `https://mtls.us.prd.caf.io`
* Para informações sobre como implementar `mTLS`, acesse [Usando mTLS](/caf-api/caf-api-pt-br/conectar/authentication/using-mtls.md)
{% endhint %}
Uma solicitação de criação de fraude suspeita insere uma fraude suspeita no banco de dados do seu par e esses dados ficam disponíveis para outros pares na rede.
{% openapi src="/files/28338081d0fcc9d493cdf67dcc6283c929f2d75b" path="/suspected-fraud" method="post" %}
[fraud.yaml](https://262277803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbVxCOSyBojfSIE5fcpfH%2Fuploads%2Fgit-blob-af815f97f3b6503a7b2dbd230f373614ea0a8abd%2Ffraud.yaml?alt=media)
{% endopenapi %}
## Modelo de dados da ocorrência
Conforme demonstrado na solicitação de exemplo, uma ocorrência de fraude suspeita é composta pelos seguintes atributos:
* `instituicao_responsavel`: é um **obrigatório** campo e é representado pelo [esquema do objeto da instituição responsável](#responsible-institution-object-instituicao_responsavel);
* `informacoes_bancarias_destino`: é um **condicional** campo e é representado pelo [esquema do objeto da conta bancária de destino](#destination-bank-account-object-informacoes_bancarias_destino);
* `informacao_executor`: é um **condicional¹** campo e é representado pelo [esquema do objeto das informações do fraudador](#fraudster-information-object-informacao_executor);
* `informacao_reclamante`: é um **condicional¹** campo e é representado pelo [esquema do objeto das informações do reclamante](#claimer-information-object-informacao_reclamante);
* `registro`: é um **obrigatório** campo e é representado pelo [esquema do objeto da ocorrência](#occurrence-object-registro).
> **¹**: Pelo menos um dos objetos, `informacao_executor` ou `informacao_reclamante`, deve estar presente.
### Objeto da Instituição Responsável: `instituicao_responsavel`
Este objeto descreve a instituição financeira que está enviando a ocorrência. Trata-se de um **objeto obrigatório**.
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| --------------------- | ------------------------------------------------------------------------------- | ------------------ | ------------ | ------ | ------------------- |
| cnpj\_origem | CNPJ da instituição financeira que está enviando a evidência de fraude. | Obrigatório | string | - | "52337497000131" |
| razao\_social\_origem | Razão social da instituição financeira que está enviando a evidência de fraude. | Obrigatório | string | - | "Empresa XYZ Ltda." |
### Objeto da Conta Bancária de Destino: `informacoes_bancarias_destino`
Este objeto descreve as informações bancárias da conta de destino da ocorrência, quando aplicável. Trata-se de um **objeto condicional**: se `registro.atividade_relacionada` for igual a: 4, 5, 6, 7 ou 8, o `informacoes_bancarias_destino` objeto é **obrigatório**.
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| agencia | Código da agência bancária de destino. Deve ser composto pelo prefixo da agência e pelo dígito verificador sem separador/hífen. | Condicional
Este campo é obrigatório quando chave\_pix.tipo for igual a: 6
| string | - | "0123" |
| codigo\_instituicao | **Obsoleto** ISPB da instituição de destino. | Condicional
Este objeto é obrigatório quando ispb não é fornecido
| inteiro | - | 00000000 |
| ispb | ISPB da instituição de destino. | Condicional
Este objeto é obrigatório quando codigo\_instituicao não é fornecido
| string | - | "00A0Z000" |
| conta | Detalhes da conta bancária de destino. | Condicional
Este objeto é obrigatório quando registro.atividade\_relacionada for igual a: 4, 5, 6, 7 ou 8;
Ou quando chave\_pix.tipo for igual a: 6
| objeto | - | - |
| conta.numero | Número da conta bancária de destino. Deve ser composto pelo prefixo da conta e pelo dígito verificador sem separador/hífen. | Obrigatório | string | - | "1234567890" |
| conta.tipo | Tipo da conta bancária de destino. | Obrigatório | inteiro | 1 - Conta de depósito à vista CV (conta corrente)
2 - Conta de depósito em poupança CP (conta poupança)
3 - Conta de pagamento pré-paga PP
| 1 |
| conta.titular | Detalhes do titular da conta de destino. | Condicional
Este campo é obrigatório quando registro.atividade\_relacionada for igual a: 4, 5, 6, 7 ou 8
| objeto | - | - |
| conta.titular.documento | Documento de identificação do titular da conta de destino. | Opcional | objeto | [esquema](#document-object) | - |
| conta.titular.nome\_completo\_razao\_social | Nome completo do titular da conta de destino. | Opcional | string | - | "Maria Silva" |
| conta.titular.nome\_fantasia | Nome empresarial do titular da conta de destino, quando aplicável. | Opcional | string | - | "Empresa XYZ" |
| conta.documento\_representante\_legal | Documentos de identificação dos representantes legais do titular da conta, quando aplicável. | Opcional | array | [esquema](#document-object) | - |
| chave\_pix | Chave PIX da conta de destino suspeita de fraude. | Condicional
Este objeto é obrigatório quando registro.atividade\_relacionada for igual a: 7
| objeto | - | - |
| chave\_pix.tipo | Tipo de chave PIX. | Obrigatório | inteiro | 1 - CPF
2 - CNPJ
3 - Número de telefone
4 - E-mail
5 - Aleatória
6 - Conta bancária
| 4 |
| chave\_pix.valor | Valor da chave PIX. | Condicional
Este campo é obrigatório quando chave\_pix.tipo não é igual a: 6
| string | - | "" |
| linha\_digitavel\_boleto | Linha digitável do boleto vinculada à suspeita de fraude na conta de destino. | Condicional
Este campo é obrigatório quando registro.atividade\_relacionada for igual a: 9
| string | - | "00190500950448160698093503143373700000001000" |
### Objeto das Informações do Fraudador: `informacao_executor`
Este objeto representa as informações do fraudador, quando disponíveis. Trata-se de um **objeto condicional**: se o `informacao_reclamante` objeto não for fornecido, o `informacao_executor` objeto é **obrigatório**. Após [GMUD Operadores de Apostas Não Autorizados | BCB 569](/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/changelog.md#2026-12-01---rs6-gmud-unauthorized-betting-operators--bcb-569), este objeto é **obrigatório** quando `registro.classificacao_irregularidade` for igual a: 1.
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| ------------------------------- | ------------------------------------------------------------------------------------- | ------------------ | ------------ | --------------------------- | ------------------- |
| nome | Nome completo ou razão social do fraudador. | Obrigatório | string | - | "João Silva" |
| documento | Documento de identificação do fraudador. | Obrigatório | objeto | [esquema](#document-object) | - |
| razao\_social | Razão social do fraudador, quando aplicável. | Opcional | string | - | "Empresa XYZ Ltda." |
| documento\_representante\_legal | Documentos de identificação dos representantes legais do fraudador, quando aplicável. | Opcional | array | [esquema](#document-object) | - |
### Objeto das Informações do Reclamante: `informacao_reclamante`
Este objeto representa as informações do reclamante. Trata-se de um **objeto condicional**: se o `informacao_executor` objeto não for fornecido, o `informacao_reclamante` objeto é **obrigatório**.
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| ------------------------------- | -------------------------------------------------------------------------------------- | ------------------ | ------------ | --------------------------- | -------- |
| documento | Documento de identificação do reclamante. | Obrigatório | objeto | [esquema](#document-object) | - |
| documento\_representante\_legal | Documentos de identificação dos representantes legais do reclamante, quando aplicável. | Opcional | array | [esquema](#document-object) | - |
### Objeto da Ocorrência: `registro`
Este objeto descreve os dados gerais da ocorrência. Trata-se de um **objeto obrigatório**.
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| data\_hora | Carimbo de data e hora no formato ISO "YYYY:MM::DDThh:mm:ss.sTZD" que indica a ocorrência da tentativa de fraude suspeita. | Obrigatório | string | - | "2024-04-03T12:00:00Z" |
| atividade\_relacionada | Atividade relacionada à ocorrência ou tentativa de fraude, conforme a lista. | Obrigatório | inteiro | 1 - Abertura de conta de depósito ou conta de pagamento
2 - Manutenção de conta de depósito ou conta de pagamento
3 - Contratação de operação de crédito
4 - Transferências entre contas da mesma instituição
5 - Transferência Eletrônica Disponível (TED)
6 - Transações de pagamento usando cheques
7 - Transações de pagamento instantâneo (Pix)
8 - Transferências por Documento de Crédito (DOC)
9 - Boletos
10 - Saques de dinheiro em espécie
11 - Prestação de serviços de ativos virtuais
| 5 |
| classificacao | Classificação da ocorrência. | Obrigatório | inteiro | 1 - Fraude Confirmada
2 - Fraude Suspeita
3 - Irregularidade
| 1 |
| classificacao\_irregularidade | Classificação do tipo de irregularidade. | Condicional
Este campo é obrigatório e exclusivo quando registro.classificacao for igual a: 3
| inteiro | 1 - Atividade como operador de apostas não autorizado | 1 |
| envolvimento\_reclamante | Indica se houve envolvimento do cliente na ocorrência ou tentativa de fraude. O envolvimento do cliente é independente de ter sido por terceiros ou não. | Obrigatório | inteiro | 1 - Sim
2 - Não
| 1 |
| valor\_transacao | Se a indicação de fraude for uma operação de pagamento, informe o valor da transação. | Condicional
Este campo é obrigatório quando registro.atividade\_relacionada for igual a: 4, 5, 6, 7, 8, 9, 10 ou 11
| número | - | 1000.00 |
| valor\_contrato | Se a indicação de fraude for uma operação de crédito, informe o valor do contrato. | Condicional
Este campo é obrigatório quando registro.atividade\_relacionada for igual a: 3
| número | - | 5000.00 |
| canal | Forma de interação ou canal usado para a execução da ocorrência ou tentativa de fraude. | Opcional | inteiro | 1 - Internet
2 - Mobile
3 - Autoatendimento
4 - Rede de parceiros
5 - Redes sociais
6 - Interbancário
7 - Outros
| 3 |
| local | Local onde a atividade foi realizada, quando aplicável. | Opcional | string | - | "Agência X" |
| motivo | Descrição da causa ou do procedimento que levou à ocorrência ou tentativa de fraude, quando aplicável. | Condicional
Este campo é obrigatório quando registro.modalidade\_fraude for igual a: 98 ou 99;
ou registro.classificacao for igual a: 3
| string | - | "Cobrança indevida" |
| modalidade\_fraude | Modalidade relacionada à ocorrência ou tentativa de fraude, conforme a lista. | Obrigatório
Este campo é obrigatório quando registro.classificacao não é igual a: 3
| inteiro | 1 - Autofraude
2 - Conta laranja
3 - Roubo de identidade (ITO)
4 - Identidade sintética
5 - Tomada de conta - ATO
6 - Fraude amigável/familiar/de segunda parte
7 - Fraude do comprador
8 - Fraude do vendedor
9 - Troca de SIM
10 - Fraude com boletos alterados
11 - Fraude de benefícios
12 - Sequestro ou extorsão
98 - Inconclusiva
99 - Modalidade não listada
| 5 |
| dispositivo | Informações sobre o dispositivo utilizado. | Opcional | objeto | - | - |
| dispositivo.identificacao | Identificação do dispositivo usado na execução da ocorrência ou tentativa de fraude. | Opcional | string | - | "ID-1234" |
| dispositivo.ip | Descrição das informações referentes ao endereço de Protocolo de Internet (IP) do dispositivo usado na ocorrência ou tentativa de fraude, quando aplicável. | Opcional | string | - | "192.168.0.1" |
| operadora\_aposta\_dominio | Domínio/URL relacionado ao operador de apostas irregular | Condicional
Este campo é opcional e exclusivo quando registro.classificacao\_irregularidade for igual a: 1
| string | - | "irregular-bet.com" |
| ativo\_virtual | Informações sobre o ativo virtual. | Condicional
Este campo é obrigatório quando registro.atividade\_relacionada for igual a: 11
| objeto | - | - |
| ativo\_virtual.tipo\_operacao | Classifica a natureza da operação informada. | Obrigatório | inteiro | 1 - Compra
2 - Venda
3 - Transferência / saque para carteira externa
4 - Recebimento de carteira externa
5 - Transferência interna entre clientes
6 - Troca entre ativos virtuais
7 - Depósito
99 - Outro
| 1 |
| ativo\_virtual.moeda | Símbolo da moeda do ativo virtual movimentado. | Obrigatório | string | Expressão regular: ^\[A-Z0-9]{1,10}$
Também deve corresponder a um símbolo canônico de ativo virtual (por exemplo, BTC, ETH, LTC, DOGE).
| "BTC" |
| ativo\_virtual.quantidade | Quantidade do ativo virtual associada à indicação de fraude. | Obrigatório | string | Expressão regular: `^\d+[.,]\d+$` | "0,00000001" |
| ativo\_virtual.transacao\_id | Identificador único da transação (hash). | Opcional | string | - | "1843b174549cfbe3f6ba979df44c5b1b4632876b6aa99b1a51057c79219b2fd8" |
#### Relação entre Modalidade de Fraude <> Atividade Relacionada
O `registro.modalidade_fraude` tem uma relação dependente com `registro.atividade_relacionada`. As relações na tabela abaixo são permitidas; qualquer relação fora da tabela é inválida. Além disso `registro.modalidade_fraude` é **bloqueado** quando `registro.classificacao` é igual a: 3.
| **atividade\_relacionada** | **modalidade\_fraude** |
| -------------------------- | ----------------------------------------- |
| **1** | 1, 2, 3, 4, 6, 9, 11, 12, 98, 99 |
| **2** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **3** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **4** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **5** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **6** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **7** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **8** | 1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 12, 98, 99 |
| **9** | Todos |
| **10** | 1, 2, 3, 4, 5, 6, 9, 11, 12, 98, 99 |
| **11** | 1, 2, 3, 4, 5, 6, 7, 8, 12, 98, 99 |
Outra relação presente no esquema foi introduzida por [GMUD Operadores de Apostas Não Autorizados | BCB 569](/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/changelog.md#2026-12-01---rs6-gmud-unauthorized-betting-operators--bcb-569), limitando os valores disponíveis de `registro.atividade_relacionada` quando `registro.classificacao_irregularidade` é igual a: 1. Os valores disponíveis são: 4, 5, 6, 7, 8, 9 e 10.
### Objeto do Documento
Este objeto representa um documento de identificação; ele pode ser o documento de uma pessoa física ou jurídica. Essa representação de objeto é usada pelo [Objeto das Informações do Reclamante](#claimer-information-object-informacao_reclamante), [Objeto das Informações do Fraudador](#fraudster-information-object-informacao_executor), e [Objeto da Conta Bancária de Destino](#destination-bank-account-object-informacoes_bancarias_destino).
| Campo | Descrição | Requisito do Campo | Tipo de dado | Opções | Exemplos |
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ | -------------------------- | ------------- |
| tipo | Indica se é uma pessoa física ou jurídica. | Obrigatório | inteiro | 1 - CPF
2 - CNPJ
| 1 |
| numero | Se o tipo de documento for "1", este atributo deve conter o CPF. Se for uma pessoa jurídica ("2"), ele deve conter o CNPJ completo. Atributo numérico, sem zeros à esquerda. | Obrigatório | string | - | "81321273070" |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.caf.io/caf-api/caf-api-pt-br/conectar/available-resources/joint-resolution-6/suspected-fraud-creation.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.