Webhooks
Overview & setup
Webhooks tell your server about invoice lifecycle changes in real time, so you don't have to poll.
How they work
When an invoice is created, paid, expires, or is canceled, we send a signed JSON POST to each active endpoint subscribed to that event. Your server verifies the signature and updates the order.
Setting up an endpoint
Configure endpoints in the dashboard. Open your store, go to its Developers tab, then Webhooks:
- Add one or more HTTPS endpoint URLs.
- Subscribe each endpoint to the events it needs.
- Copy the
signing secretshown once at creation. You'll use it to verify signatures.
Endpoints must be HTTPS. The signing secret is shown only once. Store it securely on your server.