Before you start
- Your URL must use
httpsand resolve to a public address. Payve does not deliver tolocalhostor private networks. - Your server must answer within 30 seconds, without a redirect.
- Have somewhere safe to store the signing secret, such as your secret manager.
Add the endpoint
1
Choose the environment
Sign in to the dashboard and switch to Sandbox or Live. The
endpoint receives events from that environment only.
2
Open Webhooks
Go to Settings → Webhooks. You land on the Endpoints tab.
3
Enter your URL
Select Add endpoint and type your URL in Endpoint URL, for example
https://yourapp.com/webhooks/payve.4
Choose events
Leave Events to receive on All events, or open the list and tick the ones you want.
5
Save the signing secret
Select Add endpoint. The dashboard shows a Signing secret that starts with
whsec_.
Reveal it, copy it, and store it before you select Close.Events you can choose
The full payload for each event is in Webhook event object.
Pause an endpoint
Each endpoint has a switch. Turn it off and confirm Disable this endpoint? to stop deliveries. Turn it on again to resume. Nothing is deleted while an endpoint is off. Events raised during that time are not delivered to it later, so reconcile with the API when you turn it back on.Delete an endpoint
Select the delete button on the endpoint and confirm Delete this endpoint?. Payve stops sending events to it. Past deliveries stay in the event log. A deleted endpoint cannot be restored. Adding the same URL again creates a new endpoint with a new signing secret.More than one endpoint
You can add several endpoints in one environment. Each has its own signing secret and its own event selection, and each receives its own copy of an event.Next
Verify signatures
Check that a delivery really came from Payve.
Track events
See what Payve sent and what your server answered.

