Create App Name
Shoplazza requires a public app to complete OAuth 2.0 authentication before it can use Shoplazza Open API resources. Therefore, during the app development phase, you need to create a public app.
- Log in to your partner account and go to Partner dashboard, click Apps on the left panel, then click Create app.
- Here you will add the App name and click Create.
Note
The APP name serves as the representative of the application entity and is the unique identifier used by the system during backend processing logic. This name is typically not displayed in the app market or the app installation list in the store.
- Once the app is created, your Client ID & Client Secret will be generated automatically and can be accessed from the App settings page.
App Setup
Before you can test your app on your development store, you need to add a Redirect URL to the App setup so that you can Run validate to unlock Testing.
- To add the Redirect URL, click Setup under the App setup.
- Here you can add the App URL and Redirect URL.
App URL: Primarily used for establishing a mutually trusted interaction authorization URL. Before the merchant installs the app, a request is sent to the app through this URL for authorization and to pass basic information such as the store name, store ID, HMAC, and installation source. For example, you would enter the following in the APP URL field: https://stamped-review.apps.shoplazza.com/api/auth
Redirect URL: The application's homepage, which the merchant will access after installing the app. For example, you would enter the following in the Redirect URL field: https://stamped-review.apps.shoplazza.com/api/auth/callback
Embedded Options: Refers to the content described in "How to Integrate Public Apps with Shoplazza Stores" within the public apps section.
Event Subscriptions: An event can be simply understood as a type of "notification." Event subscription means you are paying attention to a certain notification. Developers' event subscriptions are all implemented through webhook technology. Webhooks are used to push messages to developers so they can promptly understand certain business statuses and make corresponding business processing. There are currently three versions: 2020-07 and 2020-01. Usually, selecting the 2020-07 version is sufficient.
For details on which webhooks are available for each version, the meaning of each webhook, and how to use them, see: Appendix - Complete Webhook Organization.
Supported Countries: Indicate the regions where the app can be seen by developers.
Manage Listings
The App listing will be displayed in the App store where merchants can learn more about the app features and installation.It is multilingual and currently only supports English and Chinese.
- From the Apps setting page, go to App listing Manage listings.
- Click Start listing to add the required information.
- On the listing page, you can add Basic App information, Listing content, Pricing details, and Support and resources.
App Listing Name: The name used for displaying the app in the app marketplace, which is seen and used by merchants, and has multilingual capabilities. In contrast, the App Name is for developers to manage the app and serves as the unique identifier for information transmission of the app within the system.
Listing content:It is used to provide a comprehensive introduction to your app, which will be displayed in the app marketplace for merchants to see. HTML code can be utilized within the detailed description to enrich the formatting. You can use the "Preview" function to view how the app will appear in the marketplace.
Pricing details:If your application requires charging merchants for its use, you will need to configure a billing model. Currently, we only support three forms of payment methods: free installation, recurring payments, and one-time payments.