> ## 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.

# Overview

> Webhooks de billing e mapeamento para efeitos financeiros

O DEVMOB recebe webhooks de billing e traduz eventos externos em efeitos financeiros internos. Apenas eventos relevantes para pagamento, pedido, recebíveis, transferência e conta bancária produzem ação.

<Info>
  Entrada, modelagem genérica e idempotência de webhooks ficam em [Webhooks Overview](/webhooks/overview). Esta página cobre apenas o mapeamento específico de billing.
</Info>

## Fluxo

O fluxo abaixo parte de um webhook já aceito pela camada genérica e descreve apenas o efeito financeiro derivado do evento.

```mermaid theme={null}
flowchart TD
    GW["Provider de billing"] --> EP["Entrada de webhook"]
    EP --> MAP["Mapeamento para efeito financeiro"]
    MAP --> PAY["Pagamento e pedido"]
    MAP --> REC["Recebíveis"]
    MAP --> TRA["Transferência"]
    MAP --> BANK["Conta bancária"]
```

## Eventos externos mapeados

### Pagamentos

| Eventos externos                                                                                                                                                                                              | Efeito no DEVMOB                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| `PAYMENT_CREATED`, `PAYMENT_UPDATED`, `PAYMENT_AUTHORIZED`, `PAYMENT_AWAITING_RISK_ANALYSIS`, `PAYMENT_APPROVED_BY_RISK_ANALYSIS`, `PAYMENT_REPROVED_BY_RISK_ANALYSIS`                                        | Atualiza o pagamento e, quando enviado no payload, o pedido relacionado.        |
| `PAYMENT_CONFIRMED`, `PAYMENT_RECEIVED`, `PAYMENT_ANTICIPATED`                                                                                                                                                | Confirma o pagamento, atualiza o pedido e solicita sincronização de recebíveis. |
| `PAYMENT_OVERDUE`, `PAYMENT_DELETED`, `PAYMENT_RESTORED`, `PAYMENT_CREDIT_CARD_CAPTURE_REFUSED`                                                                                                               | Atualiza o status do pagamento.                                                 |
| `PAYMENT_REFUNDED`, `PAYMENT_PARTIALLY_REFUNDED`, `PAYMENT_REFUND_IN_PROGRESS`, `PAYMENT_REFUND_DENIED`, `PAYMENT_CHARGEBACK_REQUESTED`, `PAYMENT_CHARGEBACK_DISPUTE`, `PAYMENT_AWAITING_CHARGEBACK_REVERSAL` | Atualiza o pagamento com o estado de estorno ou chargeback.                     |

### Transferências

| Eventos externos                                                                                                                                    | Efeito no DEVMOB                                                     |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| `TRANSFER_CREATED`, `TRANSFER_PENDING`, `TRANSFER_IN_BANK_PROCESSING`, `TRANSFER_BLOCKED`, `TRANSFER_DONE`, `TRANSFER_FAILED`, `TRANSFER_CANCELLED` | Atualiza a transferência e sua data de liquidação quando disponível. |

### Conta bancária

| Eventos externos                                                                                                                                                                           | Efeito no DEVMOB                                                   |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
| `ACCOUNT_STATUS_BANK_ACCOUNT_INFO_APPROVED`, `ACCOUNT_STATUS_BANK_ACCOUNT_INFO_AWAITING_APPROVAL`, `ACCOUNT_STATUS_BANK_ACCOUNT_INFO_PENDING`, `ACCOUNT_STATUS_BANK_ACCOUNT_INFO_REJECTED` | Atualiza o status cadastral da conta bancária vinculada à empresa. |