Altegio account requirements

Required permissions

• Admin/manager role with API access to the salon location.
• Rights to read appointments, clients, staff, services, and schedules.
• Rights needed for actions you plan to run (create/update records, finance views, inventory).
• Ability to install marketplace applications for the location.

Optional permissions

• Tags/Labels API (some analytics and filters).
• Warehouse / goods endpoints if you use inventory prompts.
• Marketing / loyalty fields if you ask the assistant about them.

Install & SSO

1. Open the app from Altegio Marketplace (Website / Registration URL).
2. We verify signed user_data / user_data_sign and create your account session.
3. Tenant resolve calls Altegio marketplace/partner/callback to bind the salon system user.
4. Complete Stripe subscription so marketplace period_to stays aligned.

Webhooks

1. Disconnect URL in the Altegio cabinet: https://web.alt-tech.net/api/altegio/callback
2. Optional event webhook: https://web.alt-tech.net/api/altegio/webhook
3. Stripe billing webhook: https://web.alt-tech.net/api/billing/webhook

Tokens & location

• Location / salon ID is the Altegio company ID you install on.
• After install, Altegio issues a system user token for API calls (partner callback).
• Partner key verifies marketplace SSO signatures — keep it only in server env.

Common issues

• 403 Not enough rights — missing API permissions for the requested tool.
• Invalid signature — wrong marketplace partner key or tampered query params.
• Billing inactive — finish Stripe Checkout; confirm webhook or confirm-checkout.
• Wrong salon — re-open the app from the intended location in Altegio.