# Marketplace

[Integrations in the product knowledge base](https://alteg.io/en/support/knowledge-base/categories/integration-marketplace/)


Application marketplace integration for third-party applications.

**Integration workflow:**
* Partner provides domain name, registration URL, and callback URL
* User authorizes and is redirected to partner registration page
* Partner redirects back to Altegio after successful registration
* Partner confirms service activation via payment callback


## Data About Locations Connected to the Application

 - [GET /v1/marketplace/application/{application_id}/salons](https://developer.alteg.io/en/marketplace/list_marketplace_app_locations.md): This endpoint retrieves a list of locations that have connected a specific application, along with detailed information about each.

## Get application tariffs

 - [GET /v1/marketplace/application/{application_id}/tariffs](https://developer.alteg.io/en/marketplace/marketplace_partner_applications_tariffs_list.md): Retrieves list of tariffs for the application.

Note: For marketplace partners only.

## Set payment discount for locations

 - [POST /v1/marketplace/application/add_discount](https://developer.alteg.io/en/marketplace/marketplace_partner_application_add_discount.md): Sets a payment discount for specific locations when they pay through Altegio platform.

Note: This endpoint is intended for marketplace partners only.
Requires marketplace partner authorization.

## Generate payment link

 - [GET /v1/marketplace/application/payment_link](https://developer.alteg.io/en/marketplace/marketplace_partner_application_payment_link.md): Generates a payment link for application payment through Altegio platform.

Note: For marketplace partners only.

## Update notification channel availability

 - [POST /v1/marketplace/application/update_channel](https://developer.alteg.io/en/marketplace/marketplace_partner_applications_update_channel.md): Updates available notification channels for the application.

Note: Only for Chat Bots and SMS Aggregators category applications.
For marketplace partners only.

## Application Status Data for Any Location

 - [GET /v1/marketplace/salon/{location_id}/application/{application_id}](https://developer.alteg.io/en/marketplace/get_marketplace_integration_status.md): This endpoint is used to retrieve information about the application's installation status in a specific location.

## Application Uninstall

 - [POST /v1/marketplace/salon/{location_id}/application/{application_id}/uninstall](https://developer.alteg.io/en/marketplace/uninstall_marketplace_app.md): This endpoint is used by the partner service to uninstall the application from a specific location.

## Application Installation for a Location

 - [POST /v1/marketplace/partner/callback](https://developer.alteg.io/en/marketplace/marketplace_notification_settings_callback.md): The integration settings of the partner service must be sent to this address. Once received, the application will be configured and installed for the corresponding location.

## Redirect URL after user registration with the partner service

 - [POST /v1/marketplace/partner/callback/redirect](https://developer.alteg.io/en/marketplace/marketplace_notification_settings_redirect_callback.md): After completing registration, the user must be redirected to this URL in the browser, along with any required data needed by the partner service.

## Notify Altegio of Successful Payment

 - [POST /v1/marketplace/partner/payment](https://developer.alteg.io/en/marketplace/marketplace_notification_payment_callback.md): A webhook notification must be sent to this address to inform Altegio of a successful payment made on the partner service’s side.

## Chargeback Notice

 - [POST /v1/marketplace/partner/payment/refund/{payment_id}](https://developer.alteg.io/en/marketplace/marketplace_payment_refund_callback.md): Chargeback Notice

## Notify Altegio of Available SMS Sender Names

 - [POST /v1/marketplace/partner/short_names](https://developer.alteg.io/en/marketplace/set_marketplace_notification_short_names.md): This endpoint is used to send the list of SMS sender names available to the user. The user will be able to choose from any of the provided sender names.

## Webhook from Altegio About Application Events

 - [POST /v1/marketplace_webhook](https://developer.alteg.io/en/marketplace/marketplace_webhook.md): Note: This is not a callable endpoint.

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.

You can configure the webhook URL for receiving these events in your Altegio Developer Account.