Getting Started

Create your Sandbox Marketplace

We strongly recommend all users who want to develop to have their own sandbox marketplace created before upgrading to Growth package for APIs on their live marketplace. All sandbox marketplaces have API access and are free to use, they are only disabled for Live payments. This is so that you would be able to better test your custom features and save costs by only upgrading your subscription when you are ready!

To do so, simply follow the steps below

  1. Go to the Arcadier Sandbox sign up page.
    https://www.sandbox.arcadier.io/masteradmin/onboard
  2. Sign up with your preferred ID (Note: This will be the admin login for your sandbox as well!) and fill in the required fields.
  3. Select the marketplace type you would like
    • Retail Goods for BESPOKE
    • Rental Goods by Location for SPACE
    • Space Rental for SPACE
    • Rental Goods by Type for time
    • Service Booking for time
  4. Take note of your Marketplace Name as it will affect the URL of your sandbox marketplace e.g. https://{mymarketplacename}.sandbox.arcadier.io
  5. Also take note of the Currency selected as your sandbox marketplace will transact in this currency.
  6. Complete the sign-up flow by filling in the rest of the required fields.
  7. You will receive an email indicating that your marketplace has been successfully setup and you may now login to the Admin Portal!

Get your Client ID & Secret

  1. Access your admin portal, login to https://{your marketplace name}.sandbox.arcadier.io/admin
  2. Go to Account Settings, then Account Info.
  3. Your Client ID & Secret will be displayed on the bottom of your account info.
  4. Note these down but remember to keep Client Secret a secret.

More details about Client ID and Client Secret can be found here .

Trying API Calls Using Swagger

  1. Ensure that you are logged in to your Admin portal https://{your marketplace name}.sandbox.arcadier.io/admin
  2. Using the same browser go https://{your marketplace name}.sandbox.arcadier.io/admin
  3. Our full list of available APIs can be found in the left column of the swagger page.
  4. The parameters, response type and response messages and details will be shown in the right column of the page

There are 2 different ways our APIs will be called:

1. Paginated calls

API: Consumer - Get Categories

After clicking TRY, this will be the response body shown to you:

The marketplace here had 8 categories.
Choosing topRows to be 2 caused the API to GET the 2 first categories.
If it was chosen to be 4, the API would return the top 4, etc.

For this particular marketplace, choosing topRows as 8 will display all categories.
Other APIs with similar parameters can be found in the documentation.

2. Using IDs and/or keywords

For these APIs, a specific parameter will be asked and sometimes a 2nd or 3rd parameter.

The category ID was obtained from the response of Consumer - Get Categories API.

  • topRows = 8 to show all categories
  • Analyse response and find the Category named “Clothing”
  • Note down that category’s category ID.
  • Go to Consumer - Item Search API
  • Keyword to search = “Korean”
  • Category to search in = “61231” (clothing category ID)
  • The response will be like this:

Trying API Calls that Require Authorization

Other APIs such as ‘Order history’, ‘Order details’, ‘View carts’, ‘Add an item to shopping cart’, ‘Update a cart item’, ‘Remove an item from shopping cart’ and ‘Check out’ require authorization.

To get authorization to use these APIs, click on OAuth as shown below:

Choosing any of these scopes would require you to login (NOT CREATE A NEW ACCOUNT) with the credentials, then you will be redirected ack to the swagger page, with an Access token, and the OAUTH button will change to SIGNOUT.

Clicking on “TRY” will request the API to get a list of all Categories along with a set of properties of each category.

This marketplace has 8 categories; so, 8 Categories were displayed along with each category’s properties.

“Id”
A unique number to identify that category

“Name”
The name given by the admin to that category

“SortOrder”
A random number generated that will be compared to other categories to sort them in order. This number will be assigned to categories depending on their order of creation.

“ChildCategories”
The different sub categories that belong to this category. [] means there are no sub categories.

“ImageURL”
The URL of the category’s image in our servers.

Other APIs will have different attributes in their responses. What they mean and what type of variable they need to be can be found in our API documentation.