Overview
The Ideasoft App Store (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 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:
Install from the App Store
On first install and on later openings from the App Store.
- Merchant
- Install or Go to app
- App Store
- Authorization page
- Store admin panel
- code + state
- Your app
Open from the panel
When the merchant opens the app from the Apps page of the store admin panel.
- Merchant
- Apps list
- Store admin panel
- code + state
- Your app
Embedded app
When your app is registered to run inside the panel.
- Merchant
- App detail
- Store admin panel
- iframe + hmac
- Your app
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). |
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
- Getting Started: test store, app registration and required URLs.
- Installation and Authorization: verify the redirect and obtain tokens.
- Embedded Apps: if your app runs inside the panel.
- Uninstall: handle the uninstall hook.
- Publishing: testing, review, content and go-live.