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

# Tipos de eventos

> Tipos de eventos de webhook.

Esta página lista os eventos públicos que a Chargefy envia hoje por webhook.
Clique em um tipo para ver o payload completo, os campos esperados e um exemplo
de entrega.

Os tipos de evento usam namespaces separados por ponto, sem `_`. O payload do
recurso fica sempre em `data.object`.

## Eventos

| Evento                                                                                                         | Payload               | Quando acontece                                                                                                                                     |
| -------------------------------------------------------------------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`bank.account.created`](/api-reference/webhooks/bank.account.created)                                         | `bank_account`        | Ocorre quando uma bank account é criada e conectada à organização atuante.                                                                          |
| [`bank.account.detached`](/api-reference/webhooks/bank.account.detached)                                       | `bank_account`        | Ocorre quando uma bank account é desconectada da organização atuante, sem apagar a credencial bancária preservada.                                  |
| [`charge.dispute.closed`](/api-reference/webhooks/charge.dispute.closed)                                       | `dispute`             | Ocorre quando uma contestação recebe uma decisão final como `won` ou `lost`.                                                                        |
| [`charge.dispute.created`](/api-reference/webhooks/charge.dispute.created)                                     | `dispute`             | Ocorre quando uma contestação é criada para uma cobrança.                                                                                           |
| [`charge.dispute.updated`](/api-reference/webhooks/charge.dispute.updated)                                     | `dispute`             | Ocorre quando uma contestação muda de estado ou evidência.                                                                                          |
| [`charge.failed`](/api-reference/webhooks/charge.failed)                                                       | `charge`              | Ocorre quando uma tentativa de cobrança chega ao estado `failed`.                                                                                   |
| [`charge.refunded`](/api-reference/webhooks/charge.refunded)                                                   | `charge`              | Ocorre quando uma tentativa de cobrança recebe um refund parcial ou total.                                                                          |
| [`charge.succeeded`](/api-reference/webhooks/charge.succeeded)                                                 | `charge`              | Ocorre quando uma tentativa de cobrança chega ao estado `succeeded`.                                                                                |
| [`charge.updated`](/api-reference/webhooks/charge.updated)                                                     | `charge`              | Ocorre quando uma cobrança muda sem entrar diretamente nos estados finais `succeeded` ou `failed`.                                                  |
| [`checkout.session.async.payment.failed`](/api-reference/webhooks/checkout.session.async.payment.failed)       | `checkout.session`    | Ocorre quando um pagamento assíncrono de checkout, como PIX ou boleto, falha ou expira depois do checkout ter sido concluído.                       |
| [`checkout.session.async.payment.succeeded`](/api-reference/webhooks/checkout.session.async.payment.succeeded) | `checkout.session`    | Ocorre quando um pagamento assíncrono de checkout, como PIX ou boleto, é confirmado depois do checkout ter sido concluído.                          |
| [`checkout.session.completed`](/api-reference/webhooks/checkout.session.completed)                             | `checkout.session`    | Ocorre quando o comprador confirma a checkout session; em cartão, o pagamento pode já estar aprovado, e em PIX ou boleto ainda pode ficar pendente. |
| [`checkout.session.created`](/api-reference/webhooks/checkout.session.created)                                 | `checkout.session`    | Ocorre quando uma checkout session é criada pela API, pelo dashboard ou a partir de um payment link.                                                |
| [`checkout.session.expired`](/api-reference/webhooks/checkout.session.expired)                                 | `checkout.session`    | Ocorre quando uma checkout session ainda aberta expira antes do comprador concluir o checkout.                                                      |
| [`customer.created`](/api-reference/webhooks/customer.created)                                                 | `customer`            | Ocorre quando um customer é criado pela API ou materializado automaticamente durante um checkout ou cobrança.                                       |
| [`customer.deleted`](/api-reference/webhooks/customer.deleted)                                                 | `customer`            | Ocorre quando um customer é removido e deixa de aparecer nas consultas da API.                                                                      |
| [`customer.updated`](/api-reference/webhooks/customer.updated)                                                 | `customer`            | Ocorre quando dados públicos de um customer mudam, como email, documento, telefone, endereço de cobrança ou metadata.                               |
| [`invoice.created`](/api-reference/webhooks/invoice.created)                                                   | `invoice`             | Ocorre quando uma invoice é criada e fica pronta para cobrança.                                                                                     |
| [`invoice.paid`](/api-reference/webhooks/invoice.paid)                                                         | `invoice`             | Ocorre quando uma invoice chega ao estado `paid`, incluindo cobranças de assinatura, invoices manuais pagas, trials e assinaturas com valor zero.   |
| [`invoice.payment.failed`](/api-reference/webhooks/invoice.payment.failed)                                     | `invoice`             | Ocorre quando uma tentativa de pagamento de invoice falha e a invoice pode permanecer aberta para nova tentativa.                                   |
| [`invoice.voided`](/api-reference/webhooks/invoice.voided)                                                     | `invoice`             | Ocorre quando uma invoice é marcada como `void`.                                                                                                    |
| [`onboarding.session.submitted`](/api-reference/webhooks/onboarding.session.submitted)                         | `onboarding_session`  | Ocorre quando a organização conectada conclui uma onboarding session e o cadastro financeiro é recebido para análise.                               |
| [`organization.created`](/api-reference/webhooks/organization.created)                                         | `organization`        | Ocorre quando uma organização conectada é criada e vinculada a uma plataforma.                                                                      |
| [`organization.review.required`](/api-reference/webhooks/organization.review.required)                         | `organization_review` | Ocorre quando uma organização conectada precisa confirmar ou atualizar dados cadastrais.                                                            |
| [`organization.review.submitted`](/api-reference/webhooks/organization.review.submitted)                       | `organization_review` | Ocorre quando a organização conectada envia o formulário hospedado de atualização cadastral.                                                        |
| [`organization.updated`](/api-reference/webhooks/organization.updated)                                         | `organization`        | Ocorre quando o status de ativação financeira ou dados públicos de uma organização conectada mudam.                                                 |
| [`payment.intent.canceled`](/api-reference/webhooks/payment.intent.canceled)                                   | `payment_intent`      | Ocorre quando um payment intent chega ao estado `canceled`.                                                                                         |
| [`payment.intent.created`](/api-reference/webhooks/payment.intent.created)                                     | `payment_intent`      | Ocorre quando um payment intent é criado.                                                                                                           |
| [`payment.intent.failed`](/api-reference/webhooks/payment.intent.failed)                                       | `payment_intent`      | Ocorre quando uma tentativa de pagamento do payment intent chega ao estado `failed`.                                                                |
| [`payment.intent.succeeded`](/api-reference/webhooks/payment.intent.succeeded)                                 | `payment_intent`      | Ocorre quando um payment intent chega ao estado `succeeded` e o pagamento foi confirmado.                                                           |
| [`payment.intent.updated`](/api-reference/webhooks/payment.intent.updated)                                     | `payment_intent`      | Ocorre quando campos editáveis de um payment intent mudam.                                                                                          |
| [`payment.link.created`](/api-reference/webhooks/payment.link.created)                                         | `payment_link`        | Ocorre quando um payment link é criado.                                                                                                             |
| [`payment.link.updated`](/api-reference/webhooks/payment.link.updated)                                         | `payment_link`        | Ocorre quando um payment link é atualizado ou desativado.                                                                                           |
| [`payment.method.attached`](/api-reference/webhooks/payment.method.attached)                                   | `payment_method`      | Ocorre quando um payment method vira o método padrão de um customer.                                                                                |
| [`payment.method.created`](/api-reference/webhooks/payment.method.created)                                     | `payment_method`      | Ocorre quando a confirmação de um setup intent materializa um payment method salvo.                                                                 |
| [`payment.method.detached`](/api-reference/webhooks/payment.method.detached)                                   | `payment_method`      | Ocorre quando um payment method deixa de ser o método padrão do customer, sem apagar a credencial salva.                                            |
| [`payment.method.updated`](/api-reference/webhooks/payment.method.updated)                                     | `payment_method`      | Ocorre quando dados públicos de um payment method são atualizados.                                                                                  |
| [`price.created`](/api-reference/webhooks/price.created)                                                       | `price`               | Ocorre quando um price é criado diretamente ou inline durante a criação de um product.                                                              |
| [`price.updated`](/api-reference/webhooks/price.updated)                                                       | `price`               | Ocorre quando um price é atualizado ou desativado.                                                                                                  |
| [`product.created`](/api-reference/webhooks/product.created)                                                   | `product`             | Ocorre quando um product é criado.                                                                                                                  |
| [`product.updated`](/api-reference/webhooks/product.updated)                                                   | `product`             | Ocorre quando um product é atualizado ou desativado.                                                                                                |
| [`refund.created`](/api-reference/webhooks/refund.created)                                                     | `refund`              | Ocorre quando um refund é criado.                                                                                                                   |
| [`refund.failed`](/api-reference/webhooks/refund.failed)                                                       | `refund`              | Ocorre quando um refund chega ao estado `failed`.                                                                                                   |
| [`refund.updated`](/api-reference/webhooks/refund.updated)                                                     | `refund`              | Ocorre quando um refund muda de estado.                                                                                                             |
| [`receivable.created`](/api-reference/webhooks/receivable.created)                                             | `receivable`          | Ocorre quando um receivable é gerado para uma venda confirmada.                                                                                     |
| [`receivable.paid`](/api-reference/webhooks/receivable.paid)                                                   | `receivable`          | Ocorre quando um receivable é liquidado.                                                                                                            |
| [`receivable.canceled`](/api-reference/webhooks/receivable.canceled)                                           | `receivable`          | Ocorre quando um receivable é cancelado antes da liquidação.                                                                                        |
| [`receivable.refunded`](/api-reference/webhooks/receivable.refunded)                                           | `receivable`          | Ocorre quando um receivable é revertido por estorno da venda.                                                                                       |
| [`setup.intent.canceled`](/api-reference/webhooks/setup.intent.canceled)                                       | `setup_intent`        | Ocorre quando um setup intent chega ao estado `canceled`.                                                                                           |
| [`setup.intent.created`](/api-reference/webhooks/setup.intent.created)                                         | `setup_intent`        | Ocorre quando um setup intent é criado para salvar um método de pagamento.                                                                          |
| [`setup.intent.failed`](/api-reference/webhooks/setup.intent.failed)                                           | `setup_intent`        | Ocorre quando a confirmação de um setup intent falha.                                                                                               |
| [`setup.intent.succeeded`](/api-reference/webhooks/setup.intent.succeeded)                                     | `setup_intent`        | Ocorre quando um setup intent é confirmado e o método de pagamento fica salvo para o customer.                                                      |
| [`subscription.canceled`](/api-reference/webhooks/subscription.canceled)                                       | `subscription`        | Ocorre quando uma subscription passa para `canceled`, imediatamente ou ao fim de um cancelamento agendado.                                          |
| [`subscription.created`](/api-reference/webhooks/subscription.created)                                         | `subscription`        | Ocorre quando uma subscription é criada.                                                                                                            |
| [`subscription.paused`](/api-reference/webhooks/subscription.paused)                                           | `subscription`        | Ocorre quando uma subscription passa para `paused`.                                                                                                 |
| [`subscription.pending.update.applied`](/api-reference/webhooks/subscription.pending.update.applied)           | `subscription`        | Ocorre quando uma pending update é aplicada à subscription.                                                                                         |
| [`subscription.pending.update.expired`](/api-reference/webhooks/subscription.pending.update.expired)           | `subscription`        | Ocorre quando uma pending update expira antes de ser aplicada.                                                                                      |
| [`subscription.resumed`](/api-reference/webhooks/subscription.resumed)                                         | `subscription`        | Ocorre quando uma subscription pausada volta para cobrança normal.                                                                                  |
| [`subscription.trial.will.end`](/api-reference/webhooks/subscription.trial.will.end)                           | `subscription`        | Ocorre antes do fim de um trial enquanto a subscription ainda está `trialing`.                                                                      |
| [`subscription.updated`](/api-reference/webhooks/subscription.updated)                                         | `subscription`        | Ocorre quando uma subscription muda, incluindo status, método de pagamento, datas de ciclo ou metadata.                                             |
