Webhooks

Eventos da API Pagar.me v5 — order., charge., subscription.*.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da Pagar.me v5 (versão clássica). Para projetos novos, explore o API Catalog.

Webhooks são notificações enviadas para você sempre que um evento ocorre. A cada atualização, o sistema envia um HTTP POST para a URL configurada, com todas as informações relevantes sobre cobranças, pedidos, assinaturas, entre outros. Seu sistema, ao receber a notificação, executa os próximos passos.

Você tem total liberdade para escolher sobre quais eventos quer ser notificado e para qual URL cada webhook será enviado.

Contornando falhas no recebimento

Caso seu serviço não consiga receber o webhook, há configuração para definir quantas vezes a notificação será reenviada. Há também endpoint para consultar webhooks que falharam e forçar reenvio manualmente.

Funcionalidades

  • Reenviar webhook
  • Obter detalhes de um webhook
  • Listar webhooks

Eventos disponíveis

Cliente / Cartão / Endereço

EventoDescrição
customer.createdComprador criado
customer.updatedComprador atualizado
card.createdCartão criado
card.updatedCartão atualizado
card.deletedCartão deletado
address.createdEndereço criado
address.updatedEndereço atualizado
address.deletedEndereço deletado

Planos e assinaturas

EventoDescrição
plan.created · plan.updated · plan.deletedCiclo de vida do plano
planitem.*Itens do plano
subscription.created · subscription.updated · subscription.canceledCiclo de vida da assinatura
subscriptionitem.*Itens de assinatura
discount.created · discount.deletedDescontos

Pedidos e cobranças

EventoDescrição
order.create · order.paid · order.canceledCiclo de vida do pedido
order.payment_failedFalha de pagamento do pedido
invoice.created · invoice.paid · invoice.canceledFaturas
invoice.payment_failedFalha em fatura
charge.paid · charge.refunded · charge.pendingCiclo da cobrança
charge.payment_failedFalha de cobrança
checkout.createdPedido de checkout criado
Na API Unificada Stone

Os eventos foram consolidados em torno de charge.*, payment.*, payout.* e account.*, com assinatura HMAC-SHA256 obrigatória e retry exponencial automático com até 6 tentativas. Veja Foundations · Webhooks.


Jornada: SDKs e webhooks
Etapa 10 de 11