# Subscribe to webhooks

[Choose a reporting strategy](https://devportal-simpay-sbx.winkpg.io/docs/decide/reporting-strategy.md): Whether to ask this platform for payment data on a schedule, or to have it sent to you as it happens, and what each one costs you to run.

Each payment reaches you as it happens, and you act on it rather than storing it.

**Your answers so far**

- What does your reporting need from each payment? Every payment on its own, with its own detail.
- How soon after a payment do you need it? Within seconds of the payment.
- Where do these payments end up on your side? Nowhere lasting. We act on each payment and move on.

**What to build**

Write a receiver, register it as a destination, and subscribe to the events you act on. Nothing here needs a reconciliation sweep, because you aren't keeping a record whose completeness anyone will later depend on. If that changes, and it usually does, come back to this guide: the answer moves to the sweep rather than away from webhooks.

**Worth knowing**

- Delivery is at least once. Record the event id you have already handled and ignore a repeat, because a retry after a slow acknowledgement is an ordinary event rather than a fault.
- Acknowledge within five seconds. Put the raw body on a queue and process it after you have answered, because slow handling is retried and a retry is a duplicate you then have to discard.
- Verify the signature on every delivery, and reject anything that fails. Your endpoint is on the public internet and the signature is what makes an event yours.
- Watch the delivery log while you are building. It tells you whether a delivery you never saw was refused by your endpoint or never sent.

**Where to go next**

- [Quickstart: webhooks](https://devportal-simpay-sbx.winkpg.io/docs/guides/quickstart-webhooks.md)
- [Webhook integration](https://devportal-simpay-sbx.winkpg.io/docs/guides/webhook-integration.md)
- [Blueprint: receive and verify webhooks](https://devportal-simpay-sbx.winkpg.io/docs/blueprints/receive-and-verify-webhooks.md)
- [Webhook delivery log](https://devportal-simpay-sbx.winkpg.io/docs/api/notificationsGetWebhookEvents.md)

- [Start over](https://devportal-simpay-sbx.winkpg.io/docs/decide/reporting-strategy.md): go back to the first question.

## See also

- [All documentation](https://devportal-simpay-sbx.winkpg.io/llms.txt): the machine-readable index of every public page on this site.