Skip to main content

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 suborganization.updated

Disparado para a organização da plataforma quando o status de ativação financeira de uma sub-organização muda — por exemplo, quando o cadastro sai de pending para active após aprovação, ou para denied após recusa.

​
Payload de Exemplo

{
  "type": "suborganization.updated",
  "id": "evt_3KLm9XPq",
  "timestamp": "2026-04-30T18:35:00.000Z",
  "data": {
    "suborganization": {
      "id": "org_seller_new",
      "name": "Acme Importadora LTDA"
    },
    "parent_organization_id": "org_platform_owner",
    "platform_id": "plat_abc",
    "seller_activation_status": "active",
    "previous_seller_activation_status": "pending",
    "platform_reference": {
      "external_reference": "airbee_seller_456",
      "metadata": {
        "airbee_workspace_id": "ws_789"
      }
    }
  }
}

​
Campos do Payload

CampoTipoDescrição
typestring"suborganization.updated"
idstringID único do evento (evt_*).
timestampstringData/hora ISO 8601.
data.suborganization.idstringID da sub-organização (org_*).
data.suborganization.namestring | nullNome atual da sub-organização.
data.parent_organization_idstringID da organização da plataforma (destino do webhook).
data.platform_idstringID da plataforma.
data.seller_activation_statusstringStatus atual: activation_pending, pending, active, denied, disabled.
data.previous_seller_activation_statusstringStatus imediatamente anterior — útil pra detectar transições (ex: pending → active).
data.platform_referenceobjectPresente quando o vínculo carrega external_reference e/ou metadata da criação do flow.

​
Uso Típico

switch (event.type) {
  case 'suborganization.updated': {
    const { suborganization, seller_activation_status, previous_seller_activation_status } = event.data
    if (previous_seller_activation_status !== 'active' && seller_activation_status === 'active') {
      // Liberar a sub-org pra operar no seu sistema
      await db.subOrgs.update({
        id: suborganization.id,
        status: 'active',
        activated_at: new Date(),
      })
    }
    break
  }
}