> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# bank_account.updated

> Evento emitido após atualização de conta bancária por billing

`bank_account.updated` é emitido depois que uma [BankAccount](/data-modelling/billing/bank-account) é atualizada por billing.

Handlers usam este evento para executar efeitos assíncronos fora do fluxo síncrono.

## Detalhes do Evento

| Propriedade    | Valor                                      |
| -------------- | ------------------------------------------ |
| **Tipo**       | `bank_account.updated`                     |
| **Origem**     | Webhook de billing                         |
| **Publicação** | Após commit da BankAccount                 |
| **Quando**     | Billing informa mudança na conta bancária. |

## Handlers

| Handler                                | Responsabilidade                     | Dados usados | Execução    |
| -------------------------------------- | ------------------------------------ | ------------ | ----------- |
| `run-bank-account-update-side-effects` | Executa efeitos da conta atualizada. | `data`       | Assíncrona. |

## Payload

| Campo  | Tipo          | Descrição                       |
| ------ | ------------- | ------------------------------- |
| `data` | `BankAccount` | Entidade BankAccount atualizada |

## Regras dos handlers

* Handlers não rodam na transação que publicou a BankAccount.
* Falha em handler não desfaz a BankAccount.
* Cada handler deve ser idempotente.
* Novos handlers podem ser adicionados sem mudar o fluxo síncrono.

## Exemplo

```json theme={null}
{
  "type": "bank_account.updated",
  "data": {
    "bankAccountId": "0197a817-f0e7-7c45-bcf2-5b6e967c2b2a",
    "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
    "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
    "externalProvider": "billing_interface",
    "externalProviderId": "ba_5ad708e2",
    "bankCode": "001",
    "bankName": "Banco do Brasil",
    "agencyNumber": "1234",
    "accountNumber": "567890",
    "accountType": "CHECKING",
    "holderName": "Transportes Brasil Ltda",
    "holderDocument": "98765432000110",
    "holderDocumentType": "CNPJ",
    "status": "ACTIVE",
    "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
    "createdAt": "2026-07-03T14:40:00.000Z",
    "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
    "updatedAt": "2026-07-03T14:40:00.000Z"
  }
}
```