Webhook from Altegio About Application Events
Changed onThis is an example receiver path on your application backend, not an Altegio API endpoint. Altegio POSTs to the application's configured callback_url. It is separate from location entity webhook_urls.
This section describes how Altegio sends webhook notifications when specific events occur in the application-to-location lifecycle. The following event types are currently supported:
- uninstall — Sent when the application is disabled on the Altegio side.
- freeze — Sent when the integration is frozen due to service expiration.
- payment — Sent after an Altegio Marketplace billing payment is processed.
Lifecycle callbacks are emitted only in the production environment. The partner_token field lets the receiving application verify which partner originated the callback. Compare it with the expected token using a constant-time comparison. A payment event also includes the payment fields documented below and a HMAC signature. Other lifecycle events do not carry that signature.
Configure callback_url in your Altegio Developer Account. There is no partner-facing delivery log, test-send, or replay API for these callbacks.
Request
- Base URLhttps://your-app.invalid
- URLhttps://your-app.invalid/marketplace_webhook
- Authnone required
Request body
Example request
{
"salon_id": 123,
"application_id": 123,
"event": "uninstall",
"partner_token": "yasdfkjah2328aj"
}Response
From the side of the partner, a response code of successful processing (200-299) is expected.
Changes
- warning
deleted the
headerrequest parameterAccept
- warning
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new optional request property
- info
added the new
paymentenum value to the request property
- info