---
title: "Webhooks (legado)"
url: "https://devcenter.stone.com.br/legacy-webhooks"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Webhooks+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktd2ViaG9va3Mi,s_fcpx_WA8jXWYrmPY.png"
---

# 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](https://devcenter.stone.com.br/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](#funcionalidades)

-   **Reenviar webhook**
-   **Obter detalhes de um webhook**
-   **Listar webhooks**

## [Eventos disponíveis](#eventos-disponíveis)

### [Cliente / Cartão / Endereço](#cliente-cartão-endereço)

| Evento           | Descrição            |
| :--------------- | :------------------- |
| customer.created | Comprador criado     |
| customer.updated | Comprador atualizado |
| card.created     | Cartão criado        |
| card.updated     | Cartão atualizado    |
| card.deleted     | Cartão deletado      |
| address.created  | Endereço criado      |
| address.updated  | Endereço atualizado  |
| address.deleted  | Endereço deletado    |

### [Planos e assinaturas](#planos-e-assinaturas)

| Evento                                                              | Descrição                   |
| :------------------------------------------------------------------ | :-------------------------- |
| plan.created · plan.updated · plan.deleted                          | Ciclo de vida do plano      |
| planitem.*                                                          | Itens do plano              |
| subscription.created · subscription.updated · subscription.canceled | Ciclo de vida da assinatura |
| subscriptionitem.*                                                  | Itens de assinatura         |
| discount.created · discount.deleted                                 | Descontos                   |

### [Pedidos e cobranças](#pedidos-e-cobranças)

| Evento                                            | Descrição                    |
| :------------------------------------------------ | :--------------------------- |
| order.create · order.paid · order.canceled        | Ciclo de vida do pedido      |
| order.payment_failed                              | Falha de pagamento do pedido |
| invoice.created · invoice.paid · invoice.canceled | Faturas                      |
| invoice.payment_failed                            | Falha em fatura              |
| charge.paid · charge.refunded · charge.pending    | Ciclo da cobrança            |
| charge.payment_failed                             | Falha de cobrança            |
| checkout.created                                  | Pedido 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](https://devcenter.stone.com.br/foundations-webhooks).

---

**Jornada: [SDKs e webhooks](https://devcenter.stone.com.br/legacy-bibliotecas)**  
Etapa 10 de 11

[**Etapa anterior**SDK Ruby](https://devcenter.stone.com.br/legacy-sdk-ruby)[**Próxima etapa**Idempotência](https://devcenter.stone.com.br/legacy-idempotencia)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.