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

# Webhooks

> Por que o resultado final de um pagamento sempre chega por webhook.

Nem todo pagamento termina dentro do tempo de uma requisição HTTP — um gateway pode demorar, um PIX pode levar alguns segundos para ser confirmado, uma assinatura pode ter uma cobrança recorrente processada em background. Os webhooks são como a PlugToPay garante que sua aplicação sempre saiba o resultado final, independente de quanto tempo o processamento levou.

Isso é o que torna possível o [Smart Checkout Response](/concepts/smart-checkout-response): seu checkout não precisa ficar esperando a cadeia completa de pagamento, porque o resultado final é entregue de forma assíncrona, para uma URL configurada por você.

## O que você recebe

Um `POST` para o seu endpoint sempre que ocorre um evento relevante — pagamento aprovado, recusado, estornado, ou eventos de assinatura (trial, cobrança recorrente, cancelamento, entre outros).

## Entrega garantida

Se o seu endpoint não responder `2xx` a tempo, a PlugToPay reprocessa a entrega automaticamente. Cada tentativa fica registrada:

| Campo           | Descrição                        |
| --------------- | -------------------------------- |
| `status`        | `pending`, `delivered`, `failed` |
| `retry_count`   | Número de tentativas realizadas  |
| `next_retry_at` | Próxima tentativa agendada       |

Assim, uma falha temporária no seu servidor não significa perder a notificação — a entrega continua sendo tentada até ter sucesso.

## Próximos passos

* [Webhooks](/webhooks) — referência técnica completa: eventos disponíveis, payload, gerenciamento de endpoints.
* [Smart Checkout Response](/concepts/smart-checkout-response) — o mecanismo que faz o resultado final depender do webhook quando o gateway demora.
* [Status das transações](/status-codes) — estados possíveis de um pagamento e o que fazer em cada um.