> ## Documentation Index > Fetch the complete documentation index at: https://docs.chargefy.io/llms.txt > Use this file to discover all available pages before exploring further. # Evento organization.updated > Evento organization.updated. ## Evento `organization.updated` Disparado para a organização da plataforma quando o status de ativação financeira de uma organização conectada muda — por exemplo, quando o cadastro sai de `activation_pending` para `active` após aprovação, ou para `disabled` quando o perfil financeiro atual deixa de estar apto. `data.object` carrega o snapshot atual completo da organização conectada (incluindo `activation_status` e `bank_account` quando preenchidos), e `data.previous_attributes` mostra o valor anterior dos campos que mudaram — útil pra detectar transições. Use este evento para sincronizar o admin da plataforma. Quando a conta bancária ativa muda, `data.object.bank_account` traz a conta atual e `data.previous_attributes.bank_account` traz a conta anterior. ## Exemplo de payload ```json theme={} { "id": "evt_123", "object": "event", "created_at": "2026-04-30T18:35:00.000Z", "data": { "object": { "id": "org_789", "object": "organization", "activation_status": "active", "activation_status_updated_at": "2026-04-30T18:35:00.000Z", "avatar_url": "https://cdn.meusite.com/avatar.png", "bank_account": { "id": "ba_123", "object": "bank_account", "account_number_last4": "5678", "bank_code": "260", "bank_name": "Nu Pagamentos S.A.", "created_at": "2026-04-30T18:31:20.000Z", "holder_name": "Acme Importadora LTDA", "is_active": true, "is_verified": false, "livemode": true, "metadata": {}, "routing_number": "0001", "type": "checking", "updated_at": "2026-04-30T18:35:00.000Z" }, "billing_additional_info": "Recebedor: Financeiro", "billing_address": { "city": "São Paulo", "country": "BR", "line1": "Av. Paulista, 1000", "line2": null, "postal_code": "01310-100", "state": "SP" }, "billing_name": "Acme Importadora LTDA", "branding_settings": { "accent_color": null, "border_style": null, "brand_color": null, "font_family": null, "theme": null }, "created_at": "2026-04-28T13:42:10.000Z", "document": "12345678000190", "document_type": "cnpj", "email": "contato@meusite.com", "livemode": true, "metadata": {}, "name": "Acme Importadora", "platform": "plat_456", "socials": [ { "platform": "instagram", "url": "https://instagram.com/meusite" } ], "updated_at": "2026-04-30T18:35:00.000Z", "website": "https://meusite.com" }, "previous_attributes": { "activation_status": "activation_pending" } }, "livemode": true, "organization": "org_789", "request": { "id": null }, "type": "organization.updated" } ``` ## 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 originou o evento. Mesmo valor de `data.object.id`. | | `type` | `string` | `"organization.updated"` | ### `data` | Campo | Tipo | Descrição | | --------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | `object` | `object` | Snapshot atual da organização conectada. Ver tabela abaixo. | | `previous_attributes` | `object` | Mapa dos campos do `data.object` que mudaram, com o valor anterior. Pode incluir status financeiro ou dados públicos editáveis da organização. | ### `data.object` | Campo | Tipo | Descrição | | ------------------------------ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | `string` | ID público da organização conectada (`org_*`). | | `object` | `string` | Sempre `"organization"`. | | `livemode` | `boolean` | `true` em produção; `false` em ambiente de teste. | | `name` | `string` | Nome ou razão social. | | `email` | `string \| null` | E-mail principal da organização conectada. | | `avatar_url` | `string \| null` | URL da imagem de perfil/logo, quando definida. | | `document` | `string \| null` | CPF (PF) ou CNPJ (PJ), somente dígitos. | | `document_type` | `"cpf" \| "cnpj" \| null` | Tipo fiscal. | | `website` | `string \| null` | Site público da organização conectada. | | `socials` | `array` | Lista de `{ platform, url }`. `platform` é um enum: `x`, `github`, `facebook`, `instagram`, `youtube`, `linkedin`, `other`. Vazia quando não há redes cadastradas. | | `billing_name` | `string \| null` | Nome usado em cobranças. | | `billing_address` | `object \| null` | Endereço de cobrança quando informado. Campos: `line1`, `line2`, `city`, `state`, `postal_code`, `country`. | | `billing_additional_info` | `string \| null` | Informação adicional para cobranças (ex: setor responsável). | | `branding_settings` | `object` | Identidade visual aplicada ao checkout hospedado. Campos não configurados vêm `null`. | | `created_at` | `string` | Data/hora de criação da organização conectada. | | `updated_at` | `string \| null` | Data/hora da última modificação da organização conectada. | | `activation_status` | `string` | Status atual de ativação financeira. Valores: `activation_pending`, `pending`, `active`, `disabled`. `disabled` significa que o perfil financeiro atual não está apto; a organização pode iniciar uma nova tentativa de onboarding. | | `activation_status_updated_at` | `string \| null` | Data/hora ISO 8601 da última atualização de `activation_status`. | | `bank_account` | `object \| null` | Conta bancária ativa conectada à organização. Use para exibir banco, agência/roteamento, titular e últimos 4 dígitos no admin da plataforma. `null` quando ainda não há conta conectada. | | `platform` | `string` | ID da sua plataforma (`plat_*`). | | `metadata` | `object` | Metadata pública da relação plataforma↔organização conectada. Objeto vazio (`{}`) quando não houver metadata. | ### `data.previous_attributes` | Campo | Tipo | Descrição | | --------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `` | `any` | Valor anterior de um campo alterado em `data.object`. Exemplos comuns: `activation_status` quando o cadastro financeiro passa de `activation_pending` para `active`, ou `bank_account` quando a conta ativa muda. | ## Uso típico ```typescript theme={} switch (event.type) { case "organization.updated": { const organization = event.data.object; const previous = event.data.previous_attributes ?? {}; if ( previous.activation_status !== "active" && organization.activation_status === "active" ) { await db.organizations.update({ id: organization.id, status: "active", activated_at: new Date(), bank_account: organization.bank_account, }); } break; } } ```