Setup
Adding a webhook endpoint
Open the Webhooks screen
In the merchant app, go to Account (tab) → Settings → Integrations → Webhooks.
Tap "Add Webhook"
Tap the Add Webhook button in the top right.
Enter your endpoint URL
Provide the HTTPS URL where Loyalite should POST events.
https://your-server.com/webhooks/loyaliteOnly https:// URLs are accepted. HTTP endpoints are rejected.
Select event types
Choose which events trigger this endpoint:
- All Events — receive every event type (recommended for getting started)
- Selected Events — choose specific events (e.g. only
customer.enrolled)
Save and copy your secret
After saving, Loyalite displays your signing secret once.
Copy the secret now — it is never shown again. If you lose it, use Rotate Secret to generate a new one (this invalidates the old secret immediately).
Use the secret to verify webhook signatures.
Managing endpoints
Tap any endpoint to open the action menu:
| Action | Description |
|---|---|
| Edit | Change URL, description, active status, or event types |
| Test | Send a synthetic payload to verify your endpoint is reachable |
| View Deliveries | See delivery history with status, HTTP response code, and error messages |
| Rotate Secret | Generate a new signing secret (invalidates the old one immediately) |
| Delete | Permanently remove the endpoint and all its delivery history |
Active / Inactive
An endpoint can be active or inactive. Inactive endpoints do not receive deliveries — use this to pause an endpoint during maintenance without deleting it.
Test delivery
The Test action sends a synthetic payload for a selected event type to your endpoint. The test delivery appears in your delivery log and counts as a real delivery attempt.
Use test deliveries to:
- Verify your endpoint URL is reachable
- Inspect the payload shape before going live
- Debug signature verification code
Delivery log
Each endpoint has a delivery log showing:
- Event type and timestamp
- HTTP status returned by your server
- Number of delivery attempts
- Error message (if any)
- Next retry time (for failed deliveries)
See Retry Policy for how retries work.