Registro de alterações

2026-07-01 - RS6 GMUD CNPJ Alfanumérico

Alterações nos campos do dicionário de dados, em conformidade com RS6 GMUD CNPJ Alfanumérico.

A adição/alteração desses campos não impacta os registros existentes de fraude e é não retroativa. Portanto, os registros existentes continuam sendo validados de acordo com o schema pré-existente.

Durante um período de transição, novas entradas de fraude podem ser criadas usando o campo informacoes_bancarias_destino.codigo_instituicao Após a definir, somente entradas de fraude usando o informacoes_bancarias_destino.ispb serão aceitas.

Campo	Tipo de alteração	Descrição
informacoes_bancarias_destino.ispb	Inclusão	Torna obsoleto o codigo_instituicao campo. ISPB em formato de string. Campo condicional¹.
informacoes_bancarias_destino.codigo_instituicao	Obsoleto	Altera a regra de obrigatoriedade do campo. Anterior: Campo obrigatório; Atual: Campo condicional¹.
instituicao_responsavel.cnpj_origem	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacao_reclamante.documento.numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacao_executor.documento.numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacao_reclamante.documento_representante_legal[N].numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacao_executor.documento_representante_legal[N].numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacoes_bancarias_destino.conta.documento_representante_legal[N].numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacoes_bancarias_destino.conta.titular.documento.numero	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².
informacoes_bancarias_destino.chave_pix.valor	Alteração	Altera a regra de formato do campo. Anterior: String numérica; Atual: String alfanumérica².

¹: Este campo é obrigatório, informacoes_bancarias_destino.codigo_instituicao ou informacoes_bancarias_destino.ispb, somente um dos dois deve ser informado.

²: O novo formato de validação se aplica apenas ao tipo CNPJ.

2026-03-01 - Novos Endpoints (OAuth2)

Introduz mudanças críticas nos endpoints da API e nos mecanismos de autenticação para impor padrões de segurança mais rigorosos. A arquitetura de autenticação está migrando para um modelo baseado em OAuth2. Ao mesmo tempo, o fluxo para clientes que exigem Mutual TLS (mTLS) configurações foi reestruturado. Para acomodar essas atualizações de infraestrutura, os domínios e endpoints base da API foram migrados.

Todas as integrações ativas devem ser atualizadas para utilizar os novos endpoints especificados abaixo:

Ambiente	Endpoint antigo	Novo endpoint
Sandbox	api.stg.combateafraude.com.br/fraud	api.us.stg.caf.io/v1/rs6
Sandbox (mTLS)	mtls.stg.combateafraude.com.br/fraud	mtls.us.stg.caf.io/v1/rs6
Produção	api.prd.combateafraude.com/fraud	api.us.prd.caf.io/v1/rs6
Produção (mTLS)	mtls.prd.combateafraude.com/fraud	mtls.us.prd.caf.io/v1/rs6

Instruções técnicas detalhadas sobre o novo fluxo de autenticação OAuth2 e a configuração mTLS foram migradas para páginas de documentação dedicadas. Consulte os recursos a seguir para prosseguir com as atualizações de integração:

• Guia de Autenticação OAuth2;
• Guia de Uso do mTLS;
• Recursos Disponíveis.

2025-05-14 - Respostas de consulta de fraude paginadas

Adota a abordagem de paginação das respostas, ao lidar com um grande número de entradas de fraude na resposta. Alterações no Consulta de fraude suspeita.

Alterações no corpo do schema da requisição:

Campo	Tipo de alteração	Descrição
page	Inclusão	É um campo opcional, indica o número da página a ser solicitado em uma consulta paginada.

Alterações no schema da resposta:

Propriedade	Tipo de alteração	Descrição
totalPages	Inclusão	Em uma resposta paginada, indica o número total de páginas.
currentPage	Inclusão	Em uma resposta paginada, indica o número da página atual.

2025-04-16 - Ajuste na resposta de criação de fraude RS6

Inclusão do token de fraude na resposta de criação de fraude bem-sucedida.

Propriedade	Tipo de alteração	Descrição
fraudToken	Inclusão	Fornece o token de fraude de uma única criação. É uma propriedade de string.
fraudTokens	Inclusão	Fornece os tokens de fraude de uma em lote criação. É uma propriedade de array de strings.

Para mais informações, consulte a página de criação de fraude suspeita.

2025-03-10 - RS6 GMUD Q1/25

Alterações nos campos do dicionário de dados, em conformidade com RS6 GMUD Q1/25.

A adição/alteração desses campos não impacta os registros existentes de fraude e é não retroativa. Portanto, os registros existentes continuam sendo validados de acordo com o schema pré-existente.

Campo	Tipo de alteração	Descrição
informacoes_bancarias_destino .chave_pix	Inclusão	-
informacoes_bancarias_destino .linha_digitavel_boleto	Inclusão	-
registro.modalidade_fraude	Inclusão	-
registro.motivo	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo opcional; Atual: Campo condicional¹.
informacoes_bancarias_destino .agencia	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo opcional; Atual: Campo condicional².

São alterados no schema padrão, usado em Criação de fraude suspeita e no Consulta de fraude suspeita.

Esta adição impacta os de fraude e é retroativo. A inclusão de data_ultima_alteracao afeta apenas o Consulta de fraude suspeita.

Campo	Tipo de alteração	Descrição
data_ultima_alteracao	Inclusão	Indica a última alteração do registro na Interoperabilidade.

¹: Este campo é obrigatório quando registro.modalidade_fraude é igual a: 98 ou 99. Campo com requisito de minLength de 20 caracteres.

²: Este campo é obrigatório quando informacoes_bancarias_destino.chave_pix.tipo é igual a: 6.

2025-02-11 - Ajuste na obrigatoriedade dos campos RS6

Alterações na obrigatoriedade dos campos do dicionário de dados, conforme entendimento do Comitê de Interoperabilidade RS6.

A alteração desses campos impacta os de fraude e é retroativo.

Campo	Tipo de alteração	Descrição
informacoes_bancarias_destino .agencia	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo obrigatório; Atual: Campo opcional.
informacoes_bancarias_destino .codigo_instituicao	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo condicional¹; Atual: Campo obrigatório.
informacoes_bancarias_destino .conta	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo opcional; Atual: Campo condicional¹.
informacoes_bancarias_destino .conta.tipo	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo condicional¹; Atual: Campo obrigatório.
informacoes_bancarias_destino .conta.numero	Alteração	Altera a regra de obrigatoriedade do campo. Anterior: Campo opcional; Atual: Campo obrigatório.

São alterados no SuspectedFraudOccurence schema, usado no Criação de fraude suspeita e no Consulta de fraude suspeita.

¹: Este campo é obrigatório quando registro.atividade_relacionada é igual a: 4, 5, 6, 7 ou 8.