# Overview

The Ideasoft App Store ([apps.ideasoft.com.tr](https://apps.ideasoft.com.tr/)) is where merchants discover apps and integrations and install them on their stores. An App Store app is a web application that runs on your own servers and accesses store data through the [Admin API](/admin-api) with OAuth 2.0.

This section explains how your app connects to the App Store, which parameters you receive on installation and on every opening, how to verify them, and how your app is published.

## How your app is opened

Merchants reach your app in three ways:

<FlowGrid>
  <Flow title="Install from the App Store" path="merchant | Install or Go to app | appstore | Authorization page | panel | code + state | app" href="/app-store/installation">
    On first install and on later openings from the App Store.
  </Flow>
  <Flow title="Open from the panel" path="merchant | Apps list | panel | code + state | app" href="/app-store/installation">
    When the merchant opens the app from the **Apps** page of the store admin panel.
  </Flow>
  <Flow title="Embedded app" path="merchant | App detail | panel | iframe + hmac | app" href="/app-store/embedded-apps">
    When your app is registered to run inside the panel.
  </Flow>
</FlowGrid>

## Key concepts

| Concept | Description |
|---|---|
| Client ID / Client Secret | **Fixed** credentials issued by Ideasoft for your published app. Every store is authorized with the same credentials; merchants do not create API keys. |
| Redirect URL | The address the merchant is sent to on installation and on every opening, carrying `code` and `state`. |
| Uninstall Hook URL | The address the App Store notifies when your app is uninstalled. |
| `state` / `hmac` / `hash` | HMAC-SHA256 signatures you verify with your Client Secret to confirm that a request comes from Ideasoft. |
| `renew_date` | Renewal date for annually renewed products (`YYYYMMDD`). |

:::info{title="Access through the App Store"}
Merchants should access your app through the **Go to app** button in the App Store or the **Apps** page in the store admin panel. Identify the store and its authorization through the signed parameters these flows deliver.
:::

## Development steps

1. [Getting Started](/app-store/getting-started): test store, app registration and required URLs.
2. [Installation and Authorization](/app-store/installation): verify the redirect and obtain tokens.
3. [Embedded Apps](/app-store/embedded-apps): if your app runs inside the panel.
4. [Uninstall](/app-store/uninstall): handle the uninstall hook.
5. [Publishing](/app-store/publishing): testing, review, content and go-live.
