> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Set 09, 2026 - Revisão cadastral de recebedores

> Novos endpoints para consultar e responder os processos de revisão cadastral abertos pelo provedor, com seis eventos de webhook acompanhando cada etapa.

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} alt={author.name} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const alberto = {
  name: "Alberto Martins",
  title: "Software Engineer",
  url: "https://github.com/albertomalga",
  image: "https://github.com/albertomalga.png"
};

<div className="flex flex-row gap-4">
  <AuthorProfile author={alberto} />
</div>

O provedor pode pedir a atualização do cadastro dos seus recebedores, e agora esse pedido chega até você pela API. Disponibilizamos três endpoints para acompanhar e responder os processos de **revisão cadastral**, além de seis eventos de webhook que avisam a cada mudança.

## Por que isso existe

A **Resolução BCB 4.658** obriga a instituição a manter o cadastro dos recebedores atualizado. O provedor cumpre isso abrindo processos de revisão em duas modalidades: a **atualização cadastral periódica (ACP)**, do ciclo regular, e a **atualização por inconsistência (ACI)**, aberta quando um dado divergente é detectado e que já entra em cobrança ativa.

Quem coleta o dado com o recebedor é você. A Malga transporta o pedido, valida o que você envia contra a lista de campos que o provedor solicitou, e devolve a resposta dele.

## Consultar os processos

Duas rotas de leitura, com filtros por status, tipo e prazo:

* [`GET /v1/sellers/registration-reviews`](/api-reference/sellers/listar-processos-de-revisao-cadastral) — todos os processos abertos para os seus recebedores.
* [`GET /v1/sellers/{sellerId}/registration-reviews`](/api-reference/sellers/listar-processos-de-revisao-cadastral-de-um-recebedor) — os processos de um recebedor.

Cada processo traz a lista de campos pedidos já traduzida para o vocabulário da Malga, com o tipo de cada um, se é obrigatório e os valores aceitos quando houver.

## Enviar os dados coletados

[`POST /v1/sellers/{sellerId}/registration-reviews/{processId}/submit`](/api-reference/sellers/enviar-dados-de-revisao-cadastral) recebe os dados junto com a **evidência da coleta** — quando foi coletado, por qual canal e em qual jornada.

<Warning>
  Os dados precisam vir de uma **coleta ativa** com o recebedor. Reaproveitar dado do onboarding, de bureau de crédito, de base interna ou de um envio anterior é vedado pelo provedor e sujeita o recebedor a penalidade.
</Warning>

## Eventos de webhook

Seis eventos acompanham o ciclo de vida do processo:

| Evento                                | Quando chega                                 |
| ------------------------------------- | -------------------------------------------- |
| `seller.registration_review.required` | O provedor abriu o processo                  |
| `seller.registration_review.reminder` | Lembrete enquanto o processo segue sem envio |
| `seller.registration_review.overdue`  | O processo entrou em cobrança ativa          |
| `seller.registration_review.expired`  | O prazo venceu sem envio                     |
| `seller.registration_review.failed`   | O provedor recusou a submissão               |
| `seller.registration_review.finished` | O provedor confirmou o recebimento           |

Os detalhes de cada payload estão no [guia de webhooks](/documentations/webhooks/webhook1-1#eventos-de-revisão-cadastral).

<Tip>
  Features:

  1. Consulta dos processos de revisão cadastral, de todos os recebedores ou de um
  2. Envio dos dados coletados com evidência da coleta
  3. Seis eventos de webhook cobrindo abertura, lembrete, vencimento, expiração, recusa e encerramento
  4. Guia completo do fluxo em [Revisão cadastral](/documentations/split/revisao-cadastral)
</Tip>


## Related topics

- [Revisão cadastral de recebedores](/documentations/split/revisao-cadastral.md)
- [Webhooks v1.1](/documentations/webhooks/webhook1-1.md)
- [Listar processos de revisão cadastral](/api-reference/sellers/listar-processos-de-revisao-cadastral.md)
- [Mais releases](/release-notes/releases.md)