> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# hosted_flow.completed

> Disparado quando um seller submete o cadastro do hosted flow.

## Evento `hosted_flow.completed`

Disparado para a organização da plataforma quando o seller termina de
preencher o hosted flow e clica em concluir. Indica que o cadastro foi
recebido — a aprovação financeira (sair de `pending` para `active`)
chega depois via [`suborganization.updated`](https://scaleup-c34c4386.mintlify.site/api-reference/webhooks/suborganization.updated).

O payload carrega o hint da conta bancária cadastrada (banco, agência,
últimos 4 dígitos do número) — ideal pra mostrar pro seller no admin
da plataforma "sua conta termina em \*\*\*\*1234".

## Payload de Exemplo

```json theme={null}
{
  "type": "hosted_flow.completed",
  "id": "evt_3KLm9XPq",
  "timestamp": "2026-04-30T18:31:20.000Z",
  "data": {
    "hosted_flow_id": "hf_abc123",
    "platform_id": "plat_abc",
    "organization_id": "org_seller_new",
    "bank_account": {
      "holder_name": "Acme Importadora LTDA",
      "bank_code": "260",
      "bank_name": "Nu Pagamentos S.A.",
      "routing_number": "0001",
      "account_number_last4": "5678",
      "type": "checking"
    },
    "platform_reference": {
      "external_reference": "airbee_seller_456",
      "metadata": {
        "airbee_workspace_id": "ws_789"
      }
    }
  }
}
```

## Campos do Payload

| Campo | Tipo | Descrição |
| - | - | - |
| `type` | `string` | `"hosted_flow.completed"` |
| `id` | `string` | ID único do evento (`evt_*`). |
| `timestamp` | `string` | Data/hora ISO 8601. |
| `data.hosted_flow_id` | `string` | ID do hosted flow concluído (`hf_*`). |
| `data.platform_id` | `string` | ID da plataforma. |
| `data.organization_id` | `string` | ID da sub-organização (`org_*`) — use isso pra correlacionar. |
| `data.bank_account` | `object \| absent` | Hint da conta bancária cadastrada. Presente quando o seller cadastrou conta no wizard. |
| `data.bank_account.holder_name` | `string` | Nome do titular cadastrado. |
| `data.bank_account.bank_code` | `string` | Código FEBRABAN do banco (ex: `"260"`). |
| `data.bank_account.bank_name` | `string \| null` | Nome do banco resolvido (quando disponível). |
| `data.bank_account.routing_number` | `string` | Agência. |
| `data.bank_account.account_number_last4` | `string` | Últimos 4 dígitos do número da conta. |
| `data.bank_account.type` | `string` | `"checking"` (corrente) ou `"savings"` (poupança). |
| `data.platform_reference` | `object` | Echo do `external_reference` + `metadata` que você passou na criação do flow. Presente apenas se você forneceu. |

> [!NOTE]
>
> **Importante**: `hosted_flow.completed` significa "cadastro recebido",
> não "aprovado". Não libere recebimentos com base nele isoladamente —
> aguarde [`suborganization.updated`](https://scaleup-c34c4386.mintlify.site/api-reference/webhooks/suborganization.updated)
> com `seller_activation_status: "active"`.

## Uso Típico

```typescript theme={null}
switch (event.type) {
  case 'hosted_flow.completed': {
    const { hosted_flow_id, organization_id, bank_account } = event.data
    await db.subOrgs.upsert({
      id: organization_id,
      hosted_flow_id,
      bank_account_hint: bank_account, // mostrar no admin: "conta ****5678"
      activation_status: 'pending',
    })
    break
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.