Evento organization.review.submitted

Evento `organization.review.submitted`

Disparado quando a organização conectada envia o formulário hospedado de atualização cadastral. O evento é exclusivo do Chargefy for Platforms e é entregue somente aos endpoints da plataforma conectada com events_from: "platform". Endpoints com events_from: "organization" não podem assiná-lo. Este evento confirma que os dados foram recebidos para análise. Ele não indica aprovação final nem mudança imediata no status financeiro da organização. Se a atualização também alterar dados públicos da organização, como o nome, a Chargefy envia organization.updated com previous_attributes.

Depois de organization.review.submitted, continue acompanhando organization.updated para mudanças em dados públicos ou status financeiro da organização.

Este evento confirma recebimento, não aprovação. Não libere pagamentos com base nele; espere organization.updated com activation_status: "active".

Quando acontece

Situação	Como aparece no payload
O formulário hospedado foi enviado	`data.object.status: "submitted"` e `submitted_at` preenchido.
O link de preenchimento foi consumido	`url: null` neste evento.
O processo ainda aguarda análise	O evento confirma recebimento, não aprovação final.
O envio veio de uma solicitação específica	`review_type`, `requested_fields` e `submission_mode` preservam o contexto da revisão.

Como processar

Registre o id do evento (evt_*) para processar o webhook de forma idempotente.
Use data.object.id (sr_*) para marcar a atualização cadastral como enviada.
Salve submitted_at como momento de envio pelo responsável da organização.
Pare lembretes associados ao link anterior; url vem null depois do envio.
Continue aguardando organization.updated para refletir mudanças em dados públicos ou status financeiro.
Use organization para atualizar a organização conectada correta no seu sistema.

O campo top-level organization é o org_* da conta. Se precisar confirmar o estado atual, chame GET /v1/organizations/{organization} sem o header Organization.

Campos importantes

Campo	O que observar
`data.object.status`	Sempre vem como `submitted` neste evento.
`submitted_at`	Momento em que a organização enviou os dados.
`url`	Vem `null`; um novo link será entregue apenas em uma nova solicitação.
`requested_fields`	Campos ou grupos de dados solicitados no processo.
`submission_mode`	Indica se o envio era completo ou parcial.
`review_type`	Tipo normalizado da atualização cadastral.
`organization`	Organização conectada que enviou a atualização.

Status e variações

Campo	Valores relevantes
`status`	`submitted` é o estado deste evento; outros estados do processo incluem `pending`, `overdue`, `expired`, `finished` e `failed`.
`review_type`	`periodic`, `inconsistent` ou `unknown`.
`submission_mode`	`full`, `partial` ou `unknown`.

Exemplo de payload

{
  "id": "evt_rDACMJ3pCANwB9CM",
  "object": "event",
  "created_at": "2026-06-24T12:08:00.000Z",
  "data": {
    "object": {
      "id": "sr_1BpyYJsvdVbQLcZt",
      "object": "organization_review",
      "created_at": "2026-06-24T12:00:00.000Z",
      "deadline_at": "2026-07-24T12:00:00.000Z",
      "livemode": true,
      "metadata": {},
      "organization": "org_s8xhYncgp9c67AAi",
      "requested_fields": [
        "revenue",
        "address"
      ],
      "review_type": "periodic",
      "status": "submitted",
      "submission_mode": "full",
      "submitted_at": "2026-06-24T12:08:00.000Z",
      "updated_at": "2026-06-24T12:08:00.000Z",
      "url": null
    }
  },
  "livemode": true,
  "organization": "org_s8xhYncgp9c67AAi",
  "request": {
    "id": null
  },
  "type": "organization.review.submitted"
}

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Evento organization.review.submitted