Evento organization.review.submitted

Evento `organization.review.submitted`

Disparado quando a organização conectada envia o formulário hospedado de atualização cadastral. 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.

Exemplo de payload

{
  "id": "evt_123",
  "object": "event",
  "created_at": "2026-06-24T12:08:00.000Z",
  "data": {
    "object": {
      "id": "sr_123",
      "object": "organization_review",
      "created_at": "2026-06-24T12:00:00.000Z",
      "deadline_at": "2026-07-24T12:00:00.000Z",
      "livemode": true,
      "metadata": {},
      "organization": "org_456",
      "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_456",
  "request": {
    "id": null
  },
  "type": "organization.review.submitted"
}

Campos do payload

Payload

Campo	Tipo	Descrição
`id`	`string`	ID único do evento (`evt_*`).
`object`	`string`	Sempre `"event"`.
`created_at`	`string`	Data/hora ISO 8601 da geração do evento.
`livemode`	`boolean`	Mesmo valor de `data.object.livemode`.
`organization`	`string`	ID da organização conectada que enviou a atualização cadastral.
`type`	`string`	`"organization.review.submitted"`

`data.object`

Campo	Tipo	Descrição
`id`	`string`	ID da atualização cadastral.
`object`	`string`	Sempre `"organization_review"`.
`created_at`	`string`	Quando a atualização cadastral foi criada.
`deadline_at`	`string \| null`	Prazo recomendado para envio.
`livemode`	`boolean`	`true` em produção; `false` em ambiente de teste.
`metadata`	`object`	Reservado para compatibilidade; hoje retorna `{}`.
`organization`	`string`	ID da organização conectada vinculada à atualização.
`requested_fields`	`array`	Campos solicitados no processo. Interprete junto com `submission_mode`: em `full`, todos os campos exigidos pelo fluxo foram enviados; em `partial`, somente os campos listados foram enviados.
`review_type`	`string`	Tipo normalizado pela Chargefy: `periodic`, `inconsistent` ou `unknown`.
`status`	`string`	`"submitted"` neste evento.
`submission_mode`	`string`	Modo de envio normalizado pela Chargefy: `full`, `partial` ou `unknown`.
`submitted_at`	`string \| null`	Quando a organização enviou os dados.
`updated_at`	`string`	Última modificação da atualização cadastral.
`url`	`string \| null`	Sempre `null` neste evento. Se precisar de novo preenchimento depois de expirar, aguarde um novo link.

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

Uso típico

switch (event.type) {
  case "organization.review.submitted": {
    const review = event.data.object;
    await db.organizationReviews.update({
      id: review.id,
      organization: review.organization,
      status: review.status,
      submitted_at: review.submitted_at,
    });
    break;
  }
}