Skip to main content
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

EventoPayloadQuando acontece
bank.account.createdbank_accountOcorre quando uma bank account é criada e conectada à organização atuante.
bank.account.detachedbank_accountOcorre quando uma bank account é desconectada da organização atuante, sem apagar a credencial bancária preservada.
charge.dispute.closeddisputeOcorre quando uma contestação recebe uma decisão final como won ou lost.
charge.dispute.createddisputeOcorre quando uma contestação é criada para uma cobrança.
charge.dispute.updateddisputeOcorre quando uma contestação muda de estado ou evidência.
charge.failedchargeOcorre quando uma tentativa de cobrança chega ao estado failed.
charge.refundedchargeOcorre quando uma tentativa de cobrança recebe um refund parcial ou total.
charge.succeededchargeOcorre quando uma tentativa de cobrança chega ao estado succeeded.
charge.updatedchargeOcorre quando uma cobrança muda sem entrar diretamente nos estados finais succeeded ou failed.
checkout.session.async.payment.failedcheckout.sessionOcorre 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.succeededcheckout.sessionOcorre quando um pagamento assíncrono de checkout, como PIX ou boleto, é confirmado depois do checkout ter sido concluído.
checkout.session.completedcheckout.sessionOcorre 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.createdcheckout.sessionOcorre quando uma checkout session é criada pela API, pelo dashboard ou a partir de um payment link.
checkout.session.expiredcheckout.sessionOcorre quando uma checkout session ainda aberta expira antes do comprador concluir o checkout.
customer.createdcustomerOcorre quando um customer é criado pela API ou materializado automaticamente durante um checkout ou cobrança.
customer.deletedcustomerOcorre quando um customer é removido e deixa de aparecer nas consultas da API.
customer.updatedcustomerOcorre quando dados públicos de um customer mudam, como email, documento, telefone, endereço de cobrança ou metadata.
invoice.createdinvoiceOcorre quando uma invoice é criada e fica pronta para cobrança.
invoice.paidinvoiceOcorre quando uma invoice chega ao estado paid, incluindo cobranças de assinatura, invoices manuais pagas, trials e assinaturas com valor zero.
invoice.payment.failedinvoiceOcorre quando uma tentativa de pagamento de invoice falha e a invoice pode permanecer aberta para nova tentativa.
invoice.voidedinvoiceOcorre quando uma invoice é marcada como void.
onboarding.session.submittedonboarding_sessionOcorre quando a organização conectada conclui uma onboarding session e o cadastro financeiro é recebido para análise.
organization.createdorganizationOcorre quando uma organização conectada é criada e vinculada a uma plataforma.
organization.review.requiredorganization_reviewOcorre quando uma organização conectada precisa confirmar ou atualizar dados cadastrais.
organization.review.submittedorganization_reviewOcorre quando a organização conectada envia o formulário hospedado de atualização cadastral.
organization.updatedorganizationOcorre quando o status de ativação financeira ou dados públicos de uma organização conectada mudam.
payment.intent.canceledpayment_intentOcorre quando um payment intent chega ao estado canceled.
payment.intent.createdpayment_intentOcorre quando um payment intent é criado.
payment.intent.failedpayment_intentOcorre quando uma tentativa de pagamento do payment intent chega ao estado failed.
payment.intent.succeededpayment_intentOcorre quando um payment intent chega ao estado succeeded e o pagamento foi confirmado.
payment.intent.updatedpayment_intentOcorre quando campos editáveis de um payment intent mudam.
payment.link.createdpayment_linkOcorre quando um payment link é criado.
payment.link.updatedpayment_linkOcorre quando um payment link é atualizado ou desativado.
payment.method.attachedpayment_methodOcorre quando um payment method vira o método padrão de um customer.
payment.method.createdpayment_methodOcorre quando a confirmação de um setup intent materializa um payment method salvo.
payment.method.detachedpayment_methodOcorre quando um payment method deixa de ser o método padrão do customer, sem apagar a credencial salva.
payment.method.updatedpayment_methodOcorre quando dados públicos de um payment method são atualizados.
price.createdpriceOcorre quando um price é criado diretamente ou inline durante a criação de um product.
price.updatedpriceOcorre quando um price é atualizado ou desativado.
product.createdproductOcorre quando um product é criado.
product.updatedproductOcorre quando um product é atualizado ou desativado.
refund.createdrefundOcorre quando um refund é criado.
refund.failedrefundOcorre quando um refund chega ao estado failed.
refund.updatedrefundOcorre quando um refund muda de estado.
receivable.createdreceivableOcorre quando um receivable é gerado para uma venda confirmada.
receivable.paidreceivableOcorre quando um receivable é liquidado.
receivable.canceledreceivableOcorre quando um receivable é cancelado antes da liquidação.
receivable.refundedreceivableOcorre quando um receivable é revertido por estorno da venda.
setup.intent.canceledsetup_intentOcorre quando um setup intent chega ao estado canceled.
setup.intent.createdsetup_intentOcorre quando um setup intent é criado para salvar um método de pagamento.
setup.intent.failedsetup_intentOcorre quando a confirmação de um setup intent falha.
setup.intent.succeededsetup_intentOcorre quando um setup intent é confirmado e o método de pagamento fica salvo para o customer.
subscription.canceledsubscriptionOcorre quando uma subscription passa para canceled, imediatamente ou ao fim de um cancelamento agendado.
subscription.createdsubscriptionOcorre quando uma subscription é criada.
subscription.pausedsubscriptionOcorre quando uma subscription passa para paused.
subscription.pending.update.appliedsubscriptionOcorre quando uma pending update é aplicada à subscription.
subscription.pending.update.expiredsubscriptionOcorre quando uma pending update expira antes de ser aplicada.
subscription.resumedsubscriptionOcorre quando uma subscription pausada volta para cobrança normal.
subscription.trial.will.endsubscriptionOcorre antes do fim de um trial enquanto a subscription ainda está trialing.
subscription.updatedsubscriptionOcorre quando uma subscription muda, incluindo status, método de pagamento, datas de ciclo ou metadata.