Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Shipping Management
  • Publish App
  • Change Log
  • Getting Started
  • Migration to the New API
  • Shipping Management
    • Create App
    • App Cycle
    • Setup App
    • Test App
  • Order Fulfilment
    • Create App
    • App Cycle
    • Setup App
    • Test App
  • Shipments
    • Create Shipment
      POST
    • List Shipments
      GET
    • Update Shipment Details
      PUT
    • Shipment Details
      GET
    • Cancel Shipments
      POST
    • Return Shipments
      POST
    • Shipment Tracking
      GET
  • Shipping Companies
    • List Shipping Companies
      GET
    • Shipping Company Details
      GET
  1. Shipping Management

Test App

Testing and shipping are the final steps towards having your App on Salla App Store. These steps are critical and are simplified in this article.

📙 What you'll learn:#

In this article we'll go through the App testing to test the App functions using a demo store.
How to Test your Shipping App

How to Test your Shipping App#

App testing is important in order to discover defects/bugs before publishing, this guarantees that the App functions perfectly. Salla offers demo stores where developers can test their Apps.
Testing the Shipping App on demo stores provides a safe and controlled environment to evaluate App functionality and performance, helping the developer verify App behavior before publishing it.

App Testing Scenarios#

The developer can test the Shipping App with a Salla demo store to check the link between the App and Salla stores, there are a number of events that are triggered in the store including shipment.creating which is triggered by either changing the order status to Completed or by the merchant generating a shipping policy. In this testing scenario we will illustrate the merchant generating a shipping policy.
1
First Step
The developer will need to set up the App's Webhook URL to receive the store notifications, for the sake of this test we will set up a workable URL from https://webhook.site/. This will act as Salla Server, which will allow the developer to listen for Salla webhooks.
2
Second Step
Create a demo store.
3
Third Step
Install and authorize the App on the demo store.
4
Fourth Step
Create an order on the Demo Store dashboard.
5
Fifth Step
Generate a Shipping policy.
After finishing all the steps, the developer can check the Webhooks Log on the Salla Partners Portal
to see the triggered event, which in our scenario is shipment.creating.
The above summarized steps are explained below in more details including images for an elaborated explanation.
The developer may proceed to App Details page in the Partners Portal to start the App testing.
image
1.
Set up the webhook URL using Webhook stie. More details in here.
image
2.
Scroll down to App Testing section to create a demo store and click on "Create Demo Store"
image
This will prompt a from for Demo Store details
image
3.
After creating a demo store , click on Install App button located on the right of the demo store chosen.
image
This will prompt an authorization request as customary to the real time experience.
image
Click on Authorize App, which will redirect the page to the demo store where the developer can test the Shipping App.
image
4.
Create an Order on the demo store, by clicking on Orders on the right side of the page.
image
Click on create new order, and fill up creating Order details as shown below.
image
On the Orders page. Click on the order you just created to generate a Shipping policy.
image
Then, click on Issue Policy in the shipment section.
image
This action will trigger the event shipment.creating which you can view in Partners Portal Webhooks Log
image
The Shipping App must return shipment and return shipment AWB after the Shipping App receives the shipment.creating event.
Well done!! 🎉 you have successfully Tested the Shipping App using a demo store and generated a shipping policy to listen to Webhook notification of the App. The App is now ready to go through Publishing process.
Make your Shipping App a hit using these simple tips!
Modified at 2025-03-06 07:31:57
Previous
Setup App
Next
Order Fulfilment