Check out our APIs in postman >

User Management

1. Passwords

2. Registering Users

3. Single Sign-On (SSO)

 

Passwords

There are 2 scenarios in which a password would want to be changed: 

  • A user forgot their password

  • A user wishes to change a password they have not forgotten

     

Resetting forgotten passwords via API

A typical process of resetting password via API is shown in the sequence diagram below. The entire process will involve 2 different APIs:

 

 

Changing known passwords

A typical process of changing a known password is shown in the sequence diagram below. The entire process will involve only Update-Password API. 

 

 

Registering users

Guest Users

Guest users are those who browse and make purchases on the marketplace without creating an account. 

Our core product and APIs can handle a user with no registered account to purchase something on a core marketplace. For example:

 

  1. Adding an item to cart on a core marketplace as a guest user : 

    1. Navigate to item 

    2. Click Add to Cart

    3. Click on View Cart

    4. Click on Checkout

    5. Fill in user details (addresses and names)

    6. Pay

 

  1. Adding item to cart using API, as a guest user : 

    1. Get the item GUID/child item GUID

    2. Input the Quantity

    3. Use admin token as authorization token

    4. Send request.

    5. API response contains 

      1. a GUID that belongs to that user

      2. a generated authorization token for that user

    6. Continue checkout flow using that user GUID and token 

 

Any new visitor to the marketplace will be a guest user. 

 

Upgrading user roles

Getting registered as a buyer, merchant or admin can easily be done on Arcadier’s pages:

 

Guest → Registered Buyer

Click on “Register/Sign In” button

 

Guest → Registered Merchant

Click on “Be A Seller” button

 

Registered Buyer → Registered Merchant

Click on “Be A Seller” button

 

Guest OR Registered Buyer/Merchant → Sub-Admin Account

(Admin Portal) Click on “Permissions” and invite via email

On the other hand, if users are to be created or upgraded via API, this is the flow to be followed:



The 2 APIs involved in this flow are:

  1. Create User Account API - Creates an account for the user

  2. Upgrade User Role API - Upgrade the account from buyer to seller/admin

 

All details on how to use those API are found in their hyperlinks.

 

Single Sign-On (SSO)

Our single sign-on API can be used to authenticate users who want to login from an external platform.

As long as the external platform provides Arcadier with a unique ID belonging to that user, this SSO API can be used to perform SSO login.

Below shows the process of using this API to log the user in on a Arcadier marketplace :