Manage apps
Contents
1. Scenarios
Scenario 1: Use an order tool provided by your team
Situation: Your team has provided an additional order tool for daily operations. You need to use it with the correct merchant’s data.
Use this feature: Open an installed tool, or select orders from the order list for a bulk operation.
Result: The tool uses the selected merchant’s context without asking you to choose the account again.
2. Features
This page lists apps installed for the selected merchant. You can open a tool or stop its access. Users with integration management permission can browse and install apps after reviewing their permissions. Switching merchants loads that merchant’s installation list.

2.1 Open an app and check availability
The “Current version” column shows the installed version, such as 1.0.2. It changes only after you confirm an upgrade; publishing a new store version does not change it. “—” means no version record is available.
Opening an app requires integration viewing permission. In the default sidebar order, “Apps” appears immediately after “Developer Tools” at the same level. Your saved custom order is retained. Expand “Apps” in the sidebar and select an installed app by name. Select “Manage apps” to return to the installation list. You can also select “Open” from the list.
The app fills the console’s content area, with the sidebar retained. Use “Manage apps” in the sidebar or your browser’s Back button to return. You can bookmark this page or open it in a new tab; reloading checks your current access again. App actions on orders still open in an action dialog.
“Available” allows opening; “Suspended” does not. An empty list means this merchant has no installed apps. Contact the team that provides the tool.
Merchant apps can access only the merchant data covered by installation consent. Online operations also require the current user’s permission; for example, an app that sends bell notifications on your behalf needs your “Notifications” write permission (see the permission reference in Edit user). If the app version declares event notifications and you grant subscription permission, installation creates the subscription automatically and it takes effect immediately; see App credentials and webhook for its status and reactivation. One app can receive multiple subscribed event types. Events before installation are not replayed; uninstalling stops notifications.
2.2 Uninstall
Integration management permission is required. Select “Uninstall” and confirm to remove the app from the list and sidebar and invalidate its existing access. Uninstalling does not cancel orders or change inventory, and order flags the app already wrote are kept. Follow the installation flow to install it again.
2.3 Install from App Store
- Select “Browse App Store” to open App Store in the same tab with the current installation owner.
- Open an app’s details and select Install to return to this page. In the confirmation dialog, review the app icon and name, publisher, “Install for” and requested permissions. Expand “Details” to view the version and app domains.
- Enable “I agree to grant these permissions.”, then select “Agree and install”. After installation, the new app opens right away and also appears in the installed list and sidebar. Some apps only start working in the background (for example, processing new orders automatically) after they have been opened, so installation takes you straight into the app.
Admin installations belong only to the merchant selected when starting the flow. Do not switch merchants during confirmation.
Selecting a version does not install it. Cancelling grants no permissions and does not affect existing tools. If the app already has an active installation, choosing another version does not overwrite it.
▸ Installation blocked by the organization plan
If the app declares a minimum plan, the confirmation dialog checks your organization’s plan first. When the plan is below the minimum, the dialog shows a warning with the required plan and the current organization plan, without the “I agree to grant these permissions.” switch or the “Agree and install” button, and “Cancel” is the only action. Plans from lowest to highest are “Standard”, “Advanced”, “Pro” and “Enterprise”; “HCT Advanced” counts as “Advanced”.
After upgrading the plan, start the installation again from App Store. Installed apps are not affected by plan changes, and a later downgrade does not remove an existing installation.
2.4 Check for updates and upgrade
- Users with integration management permission can select “Check for updates” beside an app.
- Compare “Current version” and “Latest version”. When an update is available, review the owner, publisher, all requested permissions and app domains. New permissions are marked.
- Enable “I agree to the permissions for this version and confirm the upgrade” at the bottom of the dialog, then select “Confirm upgrade”. The consent switch and action buttons stay visible while you scroll through the details. The app then opens again; you will be guided through connection authorization if needed.
Checking does not modify the installation. Upgrading preserves the installation and integration settings, applies the new permissions and event subscriptions, and invalidates existing windows and authorizations. The app then reopens so it can reconnect on the new version. If there is no update or the destination platform does not support it, the dialog explains the result without offering upgrade confirmation.
Confirmation expires after five minutes. If the release is withdrawn, the installation or permissions change, or the login session expires, check again and review before confirming. A failed check never triggers an automatic upgrade. Ask an administrator for help with legacy installations that have no App Store version mapping.
2.5 App credentials and webhook
The API credential and event subscription an app receives at installation are viewed and maintained only on this page. They do not appear in the “Integrations” list.
The “Webhook” column shows whether events are being sent: “Connected” means events reach the app; “Deactivated” means nothing is sent right now; “Not subscribed” means this app version declares no event notifications.
Select the expand icon at the left of a row to review what the app was granted. “Granted scopes” lists the permissions approved at installation. Merchant apps use a “Partners API credential”. The “Webhook URL”, “API version” and “Subscribed events” come from the app version. They can’t be edited here, and the signing secret can’t be regenerated. To change them, upgrade the app.
▸ Reactivate an auto-deactivated subscription
When 10 events in a row fail to reach the receiver (each one counts only after all automatic retries are used), the system deactivates the subscription and sends a notification. Expand the row to see “Consecutive failures” and “Last delivery”.
- Ask the team that provides the app to fix the receiver first.
- A user with integration management permission selects “Reactivate subscription” and confirms.
- The status returns to “Connected”, the failure count resets, and events that happen afterward are delivered again. Events during the deactivated period are not replayed.
Reactivation is not possible when the app is uninstalled, suspended or taken offline, when its credential is inactive, or when its grant no longer includes the event subscription permission. The page explains the reason and the subscription stays deactivated.
▸ Test delivery and delivery log
While the subscription is active, a user with integration management permission can select “Send test delivery” to send one test event to the app’s webhook URL. The page shows the receiver’s HTTP status and the time taken. An error response shows its status code; a failed connection or no response within 20 seconds is reported as a connection failure or timeout. Test deliveries are recorded as manual; the one you send is not retried automatically and does not count toward consecutive failures.
“View deliveries” opens “Webhook Logs” filtered to this subscription including test deliveries. Select “Show all” to return to the full list. The button appears only with log viewing permission.
3. FAQ
3.1 Questions
▪ What if an app reports too many requests?
Wait before trying again and avoid repeated retries. If the problem continues, share the app name and error message with its development team. Each app has separate allowances for each merchant: 10 requests per second, 180 per minute, and 10,000 per day. If its daily allowance is exhausted, wait until midnight in the organization’s timezone. Signing in again or reinstalling does not reset usage. Apps do not consume the daily allowance shown in API Integrations, and can still operate when integrations exhaust that allowance.
▪ Why is an app missing?
Check the selected merchant first. Warehouse staff can only use tools for authorized merchants. If the merchant is correct and the list remains empty, ask the team to check the installation. If the menu is missing, ask an administrator to check integration viewing permission.
▪ What should I do when the app expires?
Reload the page in your browser, or return to the list and open the app again. For order action dialogs, close and reopen the dialog. Switching merchants, signing out, changing permissions or uninstalling can invalidate an existing window. Closing it does not undo completed operations; check saved results before retrying.
▪ What if an app does not load?
If the installation list does not load, select “Reload apps” to reload it. A loading indicator appears while the app connects. If it has not connected within 15 seconds, an error screen offers “Reload apps” to open it again. If it still cannot open, share the app name and error message with the team that provides it.
▪ Why can’t I select Browse App Store?
Select a merchant first, then ask an administrator to check that you have integration management permission.
▪ What if confirmation expires or installation fails?
After signing out, changing accounts or losing permission, select the app and version again. Retry temporary connection failures; if a version has been withdrawn, select another available version. If the store cannot open, ask an administrator to check the App Store connection settings. Share persistent errors with an administrator.
▪ The dialog says a specific plan is required and installation is not possible. What should I do?
The current organization plan is below the minimum plan declared by the app. This is not an installation failure, and retrying does not change the result; see Installation blocked by the organization plan for the plan order. Select “Cancel”, ask an administrator to upgrade the organization plan, then start the installation again from App Store. Other existing apps are not affected.
▪ Does an installed app automatically move to its new website?
It does not change automatically. Later store edits or publications do not change the version or website origin of your existing installation. Use Check for updates and upgrade, review the new domains and permissions, and explicitly confirm. Upgrading invalidates old windows and authorizations; the app then reopens automatically.
▪ Why is an app name or action button in another language?
App names and action buttons use translations included with the installed app. When no matching translation is available, the app’s default language is shown. Traditional and Simplified Chinese do not automatically substitute for each other; either may still appear if the app uses it as its default language.
▪ I was notified that a webhook was auto-deactivated and the app gets no events. What should I do?
Auto-deactivation happens only after repeated delivery failures. Ask the team that provides the app to fix the receiver, then follow Reactivate an auto-deactivated subscription. You can use a test delivery first to confirm the receiver is back. Uninstalling and reinstalling is not necessary.
▪ Why can’t I reactivate the subscription?
The page states the reason: the app is uninstalled, suspended or taken offline, its credential is inactive, or its grant no longer includes the event subscription permission. For the first two, contact the team that provides the app; for missing permission, upgrade to an app version that includes it, or contact the team that provides the app. If the button can’t be selected, ask an administrator to check that you have integration management permission.
3.2 Notices
⚠️ Important
- Uninstalling stops the app’s access immediately. Reinstalling does not restore access for old windows.
- Events that happen while the subscription is deactivated are not replayed after reactivation.
4. Related Features
| Feature | Purpose | Link |
|---|---|---|
| Order list | Select orders for a bulk tool | Open |
| Order details | Check order progress | Open |