Get started with app building

Genstore ecosystem apps are the platform's core expansion mechanism, enabling developers to build custom solutions that enhance merchant operations and maximize business value. This guide will help you quickly develop and deploy apps. We collaborate with developers worldwide to build a dynamic, long-term open ecosystem, offering merchants enhanced service quality and shopping experiences while providing developers with policy guidance, technical tools, and process support.

App ecosystem

Most Genstore apps are built by third-party developers, with some developed in-house. Developers can use Genstore's open API and tools to create new features or seamlessly integrate external services, improving efficiency. For more details, see What is the Genstore app.

App types

App Type	Description	Features
Public Apps	Apps that are reviewed and published by Genstore on the App Store. Any Genstore merchant can search, view, and install them.	• Created in the Partner Dashboard • Requires app review • Installed through the App Store
Custom Apps	Custom apps that add tailored features to your Genstore admin, specifically designed for your store and not listed in the Genstore App Store.	• Created in Genstore Admin • Not listed in the Genstore App Store • No app review required • Installed through a developer-provided link

Getting ready

Before development, review the Genstore app integration guide.

Build a publich app

Step 1: Create an app

1. Log in to the Genstore Partner portal.
2. In the left navigation menu, go to App and click Create App.
3. Enter an App name for internal use (the marketplace name can be set when you submit app listing request.

Step 2: Configure basic information

Once created, the app appears in your app list. Click the app name to open its Overview page for details.

In App configuration, configure essential details such as the app name, URL, launch method, webhook settings, navigation, contact info, and display images. For details, see App configuration.

Step 3: Develop and test the app

After setting up basic information, proceed with development and testing. Before testing, ensure the app meets merchant needs and functions properly.

1. Open the Overview page.
2. In Test app, link a test store. If no live store is available, use a Genstore development store.
3. Install and debug the app, ensuring stable performance.

Step 4: Submit and publish the app

Once testing is complete, submit your app for listing and configure marketplace details. Genstore currently supports public publishing, allowing all stores to find and install the app without restrictions.

By following these steps, you can successfully create and launch a Genstore app, providing merchants with valuable solutions. If you have any questions, contact the Developer Support Team. Let's drive e-commerce innovation together!

Build a custom app

Genstore allows you to create custom apps to meet specific business needs.

Permission preparation

You can invite collaborators or staff to create, edit, or delete custom apps and grant development permissions as well as related API scope settings.

Create app develop role

1. Log in to the Genstore admin.
2. Navigate to Settings -> Users and permissions.
3. Click Manage roles.
4. In the new window, click Create role.
5. Fill in the role Title and Description, such as Custom App Development.
6. In the Store permissions section, check App development.
7. Click Save.

Assign app develop role

After creating the role with full permissions, you can assign it to collaborators or your staff.

1. Log in to the Genstore admin, navigate to Settings -> Users and permissions.
2. In the staff list, select the user, click ... -> Edit.
3. In the staff details section, select the roles to assign.
4. Click Save.

Build custom app

Once the role is created and assigned, you can begin the development of the app. Note: Only the store owner or staff with App development permission can develop custom apps.

1. In the Genstore admin, click Apps -> Develop apps.
2. In the new window, click Build app, and fill in the following information:
   • App name: Custom app name
   • App developer: Choose the store owner or an authorized staff account
3. Click Save.

Configure custom app

Configure API access scope

Before installing the app, you need to set the API access scope.

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. In the Overview tab, click Configure API access scope. In the subsequent App configuration page, click Edit.
4. Check the required permission scopes (such as order reading, product management, etc.).
5. Click Save.

Install app

Before installing the app, you need to obtain the API credentials.

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. Click the Install app button to confirm the installation.
4. The system will generate an API Access token. Important: The Access Token is only visible the first time, so make sure to save it.

Credentials management

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. Click the Manage API credentials button or the API credentials tab to view:
   • API Key
   • API Secret
   • API Access Token (only visible the first time, recommended to view and save)

App maintenance

Update API scope

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. You can view the current API access scope in the App configuration tab.
4. Click Edit to modify the permission scope. Note: When updating the API scope, at least one permission must be retained for already installed apps.
5. Click Save.

Modify basic information

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. You can modify the following in the App settings tab:
   • App name/description
   • Primary developer (if the staff account is deleted, ownership automatically reverts to the store owner)
   • Development update notification email (optional)

Click Save once modifications are complete.

Uninstall and delete app

Uninstall app

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. Click Uninstall app.
4. The system will automatically revoke the API Token and delete Webhooks.

Permanently delete

Before deletion, ensure that the app has been uninstalled:

1. In the Genstore admin, click Apps -> Build apps.
2. In the app list, click on the target app to enter the app detail page.
3. Go to App settings -> Delete app.
4. Confirm the deletion, and all related data will be permanently deleted. Note: Deletion is irreversible, please proceed with caution.