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

# Status de cobrança

> Todos os status de cobrança em uma tabela, com o que significam, quando acontecem e o que o seu sistema deve fazer, além da marcação de bloqueio e dos status de estorno, assinatura, cartão, subconta e saque.

O status diz em que ponto da vida um objeto está. Esta página reúne todos os status documentados da API, começando pela cobrança, que é o mais usado. Use-a como referência para decidir quando liberar um pedido, quando avisar o cliente e quando abrir um tratamento de disputa.

> [!NOTE]
>
> **Para o negócio:** a regra mais segura é liberar pedido, envio ou acesso somente com a cobrança em `paid` e sem bloqueio (`isBlocked` diferente de `true`). Os demais status pedem espera, uma ação do cliente ou um tratamento de pós-venda, como mostram as tabelas.

## Status da cobrança

Lista de valores do campo `status` em `POST /v1/charges`, `GET /v1/charges`, `GET /v1/charges/{id}` e nos webhooks de cobrança.

| Status | Significado | Quando acontece | Pode mudar depois? | O que o merchant deve fazer |
| - | - | - | - | - |
| `pending` | Aguardando pagamento | Pix criado (o QR Code está disponível) ou cartão que o processador deixou pendente | Sim. Vai para `paid` quando o pagamento é confirmado, ou para `failed` ou `refused` (conforme o adquirente) se o Pix for cancelado ou expirar | Mostrar o QR Code e o copia e cola. Manter o pedido reservado. **Não liberar** |
| `paid` | Pago com sucesso | Cartão aprovado na criação, Pix pago ou pagamento confirmado depois pelo adquirente | Sim. Pode ir para `refunded`, `pre_chargeback` ou `chargeback`, e pode receber bloqueio sem mudar de status | **Liberar o pedido**, enviar o produto ou dar acesso. Antes de ações de alto valor, confirmar com `GET /v1/charges/{id}` |
| `refused` | Recusado | Cartão recusado, com o motivo em `reason` (ex.: `card_declined`, `antifraud_denied`). Também quando o 3DS obrigatório não foi concluído (`reason` começa com `3ds_`) | Trate como resultado final da tentativa | Não liberar. Mostrar mensagem amigável e oferecer outro cartão ou Pix. Guardar `reason` no log |
| `failed` | Falha no processamento | Erro ao processar a cobrança. Em alguns adquirentes, também a recusa informada depois, o cancelamento e a expiração | Trate como resultado final da tentativa | Não liberar. Oferecer nova tentativa ou outro meio de pagamento |
| `in_analysis` | Em revisão manual antifraude | Na criação, quando a análise antifraude manda a cobrança para revisão manual. A resposta traz `reason` `antifraud_manual_review` | Sim. Vai para `paid` se a análise aprovar, ou para `refused` ou `failed` se negar | Não liberar. Avisar o cliente que o pagamento está em análise. Acompanhar pelo `postbackUrl` ou por `GET /v1/charges/{id}`, porque a negativa só chega pelo `charge.updated` |
| `authentication_required` | Aguardando o comprador concluir a autenticação | Na criação, quando a política de 3D Secure da conta dispara e o banco emissor pede verificação do dispositivo ou desafio. No 3DS gerenciado, vem com `reason` `Autenticação 3DS gerenciada necessária` e `paymentDetails: null`. Alguns adquirentes também devolvem este status quando exigem autenticação do lado deles | Sim. Segue para `paid`, `pending`, `refused` ou `failed` quando a página da `authenticationUrl` conclui a autenticação e retoma a cobrança. Se o comprador abandonar, a cobrança fica neste status, sem expiração automática e sem webhook | Levar o comprador ao endereço recebido em `authenticationUrl`, sem montar nem alterar a URL. Não liberar. Se a autenticação não terminar em 15 minutos, crie uma nova cobrança |
| `refunded` | Estornado | Estorno total concluído (`charge.refunded`), alerta de pré-chargeback com estorno, contestação de Pix aceita ou reversão de saldo de um chargeback | Trate como final | Cancelar o pedido, revogar acesso e registrar a devolução |
| `pre_chargeback` | Alerta de contestação recebido antes do chargeback formal | O portador contestou a compra junto ao emissor (`charge.pre_chargeback`) | Pode evoluir dentro da disputa | Se chegou `charge.refunded` ou `chargebackAlertRefunded: true`, tratar como **estornado**. Se não, tratar como **em disputa**, sem estorno |
| `chargeback` | Chargeback formalizado | O adquirente informa a disputa de cartão. Aviso pelo `charge.updated` no `postbackUrl` | Trate como final | Registrar a perda, cancelar o pedido e acionar o fluxo interno de disputa. Confirmar com `GET /v1/charges/{id}` |

### Fluxos típicos

| Forma de pagamento | Caminho comum |
| - | - |
| Pix | `pending` → `paid` → (opcional) `refunded` |
| Cartão aprovado | `paid` → (opcional) `refunded`, `pre_chargeback` ou `chargeback` |
| Cartão recusado | `refused` |
| Cartão com 3D Secure com verificação ou desafio | `authentication_required` → `paid`, `pending`, `refused` ou `failed` |
| Cartão em revisão antifraude | `in_analysis` → `paid`, `refused` ou `failed` |

O desenho abaixo mostra como a cobrança sai da criação e chega a um resultado.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"defaultRenderer": "elk", "curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
flowchart TB
    S(["POST /v1/charges"]):::neutro
    AUT["authentication_required<br/>aguardando o comprador"]:::alerta
    J(["cobrança<br/>retomada"]):::neutro
    AN["in_analysis<br/>em revisão antifraude"]:::alerta
    PEN["pending<br/>aguardando pagamento"]:::alerta
    PAID(["paid<br/>pago"]):::ok
    REF(["refused · failed<br/>recusado ou falhou"]):::erro
    S -->|"3DS com verificação<br/>ou desafio"| AUT
    S -->|"Pix criado ou<br/>cartão pendente"| PEN
    S -->|"revisão manual"| AN
    S ==>|"cartão aprovado"| PAID
    S -->|"cartão recusado<br/>ou erro"| REF
    AUT -->|"comprador conclui<br/>na authenticationUrl"| J
    J --> PEN
    J --> PAID
    J --> REF
    PEN ==>|"pagamento confirmado"| PAID
    PEN -->|"Pix cancelado<br/>ou expirado"| REF
    AN -->|"análise aprova"| PAID
    AN -->|"análise nega"| REF
    classDef alerta fill:#FFF6E5,stroke:#B45309,stroke-width:1.5px,color:#5C3D00
    classDef erro fill:#FDECEC,stroke:#B42318,stroke-width:1.5px,color:#7A1209
    classDef neutro fill:#FFFFFF,stroke:#B8C2D1,stroke-width:1.5px,color:#344054
    classDef ok fill:#E8F7EE,stroke:#15803D,stroke-width:1.5px,color:#0B4A23
```

Se o comprador abandona a autenticação, a cobrança fica em `authentication_required`, sem expiração automática e sem webhook.

### Como o status chega até você

| Status | Resposta da criação | Endpoints de webhook | `postbackUrl` da cobrança |
| - | - | - | - |
| `pending` | Sim | `charge.created` e `charge.pending` | `charge.created` e `charge.pending` |
| `paid` | Sim (cartão aprovado na hora) | `charge.paid` | `charge.paid` e, quando o adquirente informa o pagamento, `charge.updated` |
| `refused`, `failed` na criação ou no fim do 3DS gerenciado | Sim, na criação | `charge.refused` ou `charge.failed` | `charge.refused` ou `charge.failed` e, no 3DS gerenciado, `charge.updated` |
| `refused`, `failed` informados depois pelo adquirente | Não | Nada | Só `charge.updated` |
| `in_analysis` | Sim | Só `charge.created` | Só `charge.created` |
| `authentication_required` | Sim, com `authenticationUrl` | Só `charge.created` | Só `charge.created` |
| `refunded` | Não | `charge.refunded` | `charge.refunded` e, quando vem do adquirente, `charge.updated` |
| `pre_chargeback` | Não | `charge.pre_chargeback` (e `charge.refunded`, se houve estorno) | Os mesmos eventos, mais `charge.updated` |
| `chargeback` | Não | `charge.refunded`, só quando a reversão devolve o valor do saldo | `charge.updated` com `status: "chargeback"` e, quando há reversão de saldo, `charge.refunded` |

Formato dos eventos: [Catálogo de eventos](https://docs.fastpaybrasil.com/anexos/catalogo-de-eventos.md).

## Bloqueio (`isBlocked`)

O bloqueio é uma **marcação**, separada do status. Uma cobrança bloqueada continua `paid` e passa a ter `isBlocked: true`, `blockedAt` e `blockedReason` (no envelope padrão do webhook, `is_blocked`, `blocked_at` e `blocked_reason`). Na API não existe status nem evento chamado MED ou chargeback em análise: o integrador vê essa marcação.

| Ponto | Como funciona |
| - | - |
| Quem aplica | A equipe da Finvia, e só em cobranças `paid`. O bloqueio não chega automaticamente do banco |
| Aviso | `charge.blocked` aos endpoints e ao `postbackUrl`. Quem tem `postbackUrl` recebe também o `charge.updated` |
| Saldo | O que a venda já liquidou (o líquido mais as taxas da venda) sai do saldo disponível e vai para o saldo bloqueado. Parcelas que liquidarem durante o bloqueio também caem no saldo bloqueado |
| `blockedReason` | Texto livre preenchido pela Finvia. Pode indicar MED ou chargeback e pode vir vazio |
| Como saber se está bloqueada | Leia `isBlocked`. Na liberação, `blockedReason` é apagado, mas `blockedAt` continua preenchido |
| Listar bloqueadas | `GET /v1/charges?status=blocked` |
| Liberação | Volta `isBlocked: false` e **não gera webhook nem postback**. Confirme por `GET /v1/charges/{id}` |

### MED e chargeback

| | MED (Mecanismo Especial de Devolução) | Chargeback |
| - | - | - |
| Meio de pagamento | Só Pix | Só cartão |
| Na API | Bloqueio da cobrança (`isBlocked: true`, `charge.blocked`), status continua `paid` | Pode começar com alerta de pré-chargeback (`pre_chargeback`) e bloqueio. A formalização muda o status para `chargeback` |
| Desfecho a favor do merchant | Liberação do bloqueio: `isBlocked: false`, sem webhook | Liberação do bloqueio: `isBlocked: false`, sem webhook |
| Desfecho contra o merchant | Contestação aceita: estorno, status `refunded` e `charge.refunded` | Status `chargeback`, informado pelo adquirente. Aviso por `charge.updated` no `postbackUrl` e, se a reversão devolver o valor do saldo, `charge.refunded`. Se a cobrança já tinha sido estornada no pré-chargeback, só o `charge.updated` |

O MED é diferente do bloqueio cautelar do Pix, que é outra ferramenta: uma retenção preventiva e curta feita pela instituição do recebedor quando suspeita de fraude. Na API, os dois aparecem da mesma forma, como bloqueio da cobrança.

O desenho abaixo mostra o que pode acontecer com uma cobrança depois de paga, inclusive o bloqueio, que não muda o status.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"defaultRenderer": "elk", "curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
flowchart TB
    PAID(["paid<br/>pago"]):::ok
    BLQ["bloqueada: isBlocked true<br/>o status segue paid"]:::alerta
    LIB(["liberada, segue paid<br/>isBlocked false<br/>sem webhook"]):::ok
    PRE["pre_chargeback<br/>alerta de contestação"]:::alerta
    RFD(["refunded<br/>estornado"]):::neutro
    CB(["chargeback<br/>formalizado"]):::erro
    PAID -->|"estorno total"| RFD
    PAID -->|"Finvia bloqueia<br/>MED ou disputa"| BLQ
    PAID -->|"portador contesta<br/>no emissor"| PRE
    PAID -->|"adquirente informa<br/>a disputa"| CB
    BLQ -->|"bloqueio retirado"| LIB
    BLQ -->|"Pix: contestação<br/>aceita"| RFD
    BLQ -->|"cartão: chargeback<br/>perdido"| CB
    PRE -->|"alerta com estorno"| RFD
    PRE -->|"disputa<br/>formalizada"| CB
    classDef alerta fill:#FFF6E5,stroke:#B45309,stroke-width:1.5px,color:#5C3D00
    classDef erro fill:#FDECEC,stroke:#B42318,stroke-width:1.5px,color:#7A1209
    classDef neutro fill:#FFFFFF,stroke:#B8C2D1,stroke-width:1.5px,color:#344054
    classDef ok fill:#E8F7EE,stroke:#15803D,stroke-width:1.5px,color:#0B4A23
```

**1. Bloqueio recebido**

Ao receber `charge.blocked` (ou `charge.updated` com `isBlocked: true`), identifique a cobrança por `data.id` e marque o pedido como "em disputa".

**2. Defesa**

Não existe rota de API para enviar defesa de MED ou de chargeback. O alerta de chargeback ou MED chega por e-mail à conta (no Connect, à conta master), e a defesa com as evidências é enviada em resposta a esse e-mail, dentro do prazo indicado nele. Dúvidas, pelo suporte. Detalhes em [Bloqueio, chargeback e MED](https://docs.fastpaybrasil.com/guias/bloqueio-chargeback-med.md).

**3. Desfecho**

Como a liberação não gera aviso, consulte periodicamente `GET /v1/charges/{id}` das cobranças em disputa. `isBlocked: false`: restaure o pedido. `status` `refunded` ou `chargeback`: registre a perda e acione o cancelamento.

> [!WARNING]
>
> O status `chargeback` e as recusas assíncronas chegam só pelo `charge.updated`, que vai **somente** para o `postbackUrl` da cobrança. No chargeback, os endpoints recebem apenas o `charge.refunded`, e só quando o valor é revertido do saldo. Se a sua integração não informa `postbackUrl`, acompanhe essas cobranças por `GET /v1/charges/{id}`.

## Status do estorno

Resposta de `POST /v1/refunds`. É o status da **operação de estorno**, separado do status da cobrança.

| Status | Significado | O que fazer |
| - | - | - |
| `refunded` | O estorno foi registrado na Finvia e o valor saiu do saldo do lojista. A cobrança passa a `refunded` e `charge.refunded` é enviado | Registrar a devolução. Não reenviar o pedido de estorno |

Hoje a API devolve só `refunded`. Prazos, casos especiais e o que fazer se o comprador não receber estão em [Estorno](https://docs.fastpaybrasil.com/guias/estorno.md).

## Status da assinatura

Campo `status` de `POST /v1/subscriptions`, `GET /v1/subscriptions`, `GET /v1/subscriptions/{id}` e dos webhooks `subscription.*`. Na criação, os status possíveis são `active` e `pending_activation`.

| Status | Significado | O que o merchant deve fazer |
| - | - | - |
| `pending_activation` | A primeira cobrança foi recusada ou está em análise. A assinatura não está ativa, não cobra, não renova e não tem retentativa automática. Se a análise aprovar o pagamento, passa a `active` automaticamente | Não liberar acesso. Se recusada, criar uma nova assinatura (por exemplo, com outro cartão) e, se quiser, cancelar a pendente. Se em análise, aguardar `subscription.activated` ou `subscription.payment_failed` |
| `active` | Ativa e em dia. Continua `active` durante as retentativas de renovação | Manter o acesso. A cada `subscription.payment_failed`, avisar o cliente |
| `cancelled` | Cancelada. Novas cobranças não são feitas | Arrependimento (`regret`): revogar acesso imediatamente. Regular (`regular`): manter acesso até `current_period_end` |
| `expired` | Encerrada por esgotar as retentativas do ciclo ou porque o plano chegou ao `endDate` | Revogar o acesso |

O desenho abaixo mostra o ciclo de vida da assinatura.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"defaultRenderer": "elk", "curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
flowchart TB
    S(["POST /v1/subscriptions"]):::neutro
    PA["pending_activation<br/>não cobra nem renova"]:::alerta
    AC["active<br/>ativa e em dia"]:::ok
    RT["Renovação recusada<br/>retentativas, segue active"]:::alerta
    CA(["cancelled<br/>cancelada"]):::neutro
    EX(["expired<br/>encerrada"]):::erro
    S -->|"primeira cobrança<br/>aprovada ou trial"| AC
    S -->|"primeira cobrança<br/>recusada ou em análise"| PA
    PA -->|"análise aprova"| AC
    PA -->|"cancelamento"| CA
    AC -->|"cancelamento"| CA
    AC -->|"cobrança do ciclo<br/>recusada"| RT
    RT -.->|"retentativa<br/>aprovada"| AC
    RT -->|"tentativas<br/>esgotadas"| EX
    AC -->|"endDate<br/>do plano"| EX
    classDef alerta fill:#FFF6E5,stroke:#B45309,stroke-width:1.5px,color:#5C3D00
    classDef erro fill:#FDECEC,stroke:#B42318,stroke-width:1.5px,color:#7A1209
    classDef neutro fill:#FFFFFF,stroke:#B8C2D1,stroke-width:1.5px,color:#344054
    classDef ok fill:#E8F7EE,stroke:#15803D,stroke-width:1.5px,color:#0B4A23
```

Uma assinatura em `pending_activation` com a primeira cobrança recusada não é cobrada de novo. Para tentar outro cartão, crie uma nova assinatura.

### Status da cobrança dentro da assinatura

No histórico `charges` de `GET /v1/subscriptions/{id}`. Há uma linha por tentativa: as retentativas recusadas de um ciclo repetem o mesmo `billingCycle`.

| Status | Significado |
| - | - |
| `pending` | Em análise |
| `paid` | Paga com sucesso |
| `failed` | Falhou |
| `refunded` | Estornada |

## Status do cartão salvo

Os valores dependem da rota.

| Status | Onde aparece | Significado |
| - | - | - |
| `active` | Listagem e consulta | Pronto para uso. Com o processador atual, todo cartão nasce `active` |
| `expired` | Listagem e consulta | A validade do cartão passou |
| `revoked` | Listagem e consulta | O cartão foi excluído com `DELETE /v1/cards/{id}` |
| `inactive` | Só na consulta (`GET /v1/cards/{id}`) | A assinatura que usava o cartão foi cancelada e nenhuma outra o usa. Volta a `active` se o cliente assinar de novo com ele |
| `pending_validation` | Só na consulta | Só em cartões antigos do processador anterior |

Para saber se um cartão pode ser usado em `POST /v1/charges`, use a listagem `GET /v1/cards`: a cobrança recusa cartão `revoked` ou `expired`.

## Status da subconta (Connect)

Campo `status` de `GET /v1/submerchants` e `GET /v1/submerchants/{merchantId}`. Só a subconta `active` opera.

| Status | Significado | Gera aviso de status de conta? | O que fazer |
| - | - | - | - |
| `pending` | Cadastro recebido, em análise. Também depois que uma correção é reenviada | Não | Enviar todos os documentos e aguardar |
| `pre_approved` | Documentos obrigatórios conferidos. A subconta está sendo credenciada nas adquirentes e aguarda a aprovação final | Sim | Aguardar a aprovação final |
| `correcting` | A Finvia pediu correção de dados ou documentos. Só acontece a partir de `pending` ou `pre_approved`. O motivo vem em `rejectionReason` | Sim | Corrigir pelo painel, na gestão de subcontas. A correção não é feita pela API |
| `active` | Aprovada e apta a transacionar | Sim, na aprovação e no desbloqueio | Liberar vendas e obter as chaves da subconta |
| `rejected` | Reprovada. Motivo em `rejectionReason` | Sim | Informar o vendedor |
| `blocked` | Bloqueada | Sim | Suspender as vendas da subconta até o desbloqueio |
| `inactive` | Inativada | Não | Encerrar a operação do vendedor |

Fluxo comum: `pending` → `pre_approved` → `active`. Pedidos de correção levam a `correcting`, e a conta volta a `pending` quando os dados são reenviados. O aviso de status vai para a URL de aviso de status da subconta, como explica [Webhooks de conta](https://docs.fastpaybrasil.com/guias/webhooks/conta.md).

O desenho abaixo mostra o fluxo comum de aprovação da subconta e o ciclo de correção.

```mermaid placement="top-right" className="finvia-diagrama" theme={null}
%%{init: {"theme": "base", "fontFamily": "Inter, sans-serif", "themeVariables": {"fontFamily": "Inter, Arial, sans-serif", "fontSize": "15px", "primaryColor": "#EAF3FF", "primaryBorderColor": "#017AFF", "primaryTextColor": "#070D15", "secondaryColor": "#F3F5F8", "tertiaryColor": "#FFFFFF", "lineColor": "#5B6B82", "textColor": "#070D15", "edgeLabelBackground": "#FFFFFF", "clusterBkg": "#F7F9FC", "clusterBorder": "#D5DCE6", "actorBkg": "#FFFFFF", "actorBorder": "#98A2B3", "actorTextColor": "#070D15", "actorLineColor": "#B8C2D1", "signalTextColor": "#070D15", "labelBoxBkgColor": "#EAF3FF", "labelBoxBorderColor": "#017AFF", "labelTextColor": "#003A7A", "loopTextColor": "#070D15", "noteBkgColor": "#FFF6E5", "noteBorderColor": "#F0B44C", "noteTextColor": "#5C3D00", "activationBkgColor": "#EAF3FF", "activationBorderColor": "#017AFF", "sequenceNumberColor": "#FFFFFF", "signalColor": "#5B6B82"}, "flowchart": {"curve": "basis", "nodeSpacing": 45, "rankSpacing": 55, "padding": 18}, "sequence": {"mirrorActors": false, "showSequenceNumbers": true, "actorMargin": 60, "messageMargin": 38, "boxMargin": 10, "noteMargin": 12, "wrap": true}}}%%
flowchart TB
    P["pending<br/>em análise"]:::alerta
    PRE["pre_approved<br/>documentos conferidos"]:::alerta
    A(["active<br/>pode vender"]):::ok
    C["correcting<br/>correção pedida"]:::alerta
    P -->|"documentos<br/>conferidos"| PRE
    PRE -->|"aprovação final"| A
    P -->|"Finvia pede<br/>correção"| C
    PRE -->|"Finvia pede<br/>correção"| C
    C -->|"dados reenviados<br/>pelo painel"| P
    classDef alerta fill:#FFF6E5,stroke:#B45309,stroke-width:1.5px,color:#5C3D00
    classDef ok fill:#E8F7EE,stroke:#15803D,stroke-width:1.5px,color:#0B4A23
```

Os status `rejected`, `blocked` e `inactive` estão na tabela acima.

## Status do saque

Status de uma solicitação de saque, da própria conta ou de subconta.

| Status | Significado | O que fazer |
| - | - | - |
| `pending` | Solicitação criada. O valor bruto já saiu do saldo disponível e aguarda decisão | Aguardar |
| `approved` | Aprovado e enviado para pagamento. Nos saques de subconta, gera o webhook `payout.approved` | Registrar o valor líquido (`netAmount`) |
| `rejected` | Rejeitado. O valor volta ao saldo disponível e o motivo fica em `rejectionReason`. Nos saques de subconta, gera o webhook `payout.rejected` | Informar o solicitante e corrigir a causa |

Só os saques de subconta geram webhook. O saque da própria conta é acompanhado pela [listagem de saques](https://docs.fastpaybrasil.com/referencia/saques/listar.md).

## Status do plano de assinatura

| Status | Significado |
| - | - |
| `active` | Disponível para novas assinaturas |
| `inactive` | Indisponível para novas assinaturas. As assinaturas existentes continuam renovando normalmente |

## Veja também

> [card] [Catálogo de eventos](https://docs.fastpaybrasil.com/anexos/catalogo-de-eventos.md)
>
> Todos os eventos de webhook e seus formatos.

> [card] [Bloqueio, chargeback e MED](https://docs.fastpaybrasil.com/guias/bloqueio-chargeback-med.md)
>
> Como funciona a disputa e a defesa.

> [card] [Ciclo de vida da assinatura](https://docs.fastpaybrasil.com/guias/assinaturas/ciclo-de-vida.md)
>
> Renovação, retentativa e cancelamento.

> [card] [Subcontas e KYC](https://docs.fastpaybrasil.com/guias/fast-connect/subcontas-e-kyc.md)
>
> Cadastro e aprovação de subcontas.


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