Creating a connection

Establishing connection of Eshopbox Workspace with woocommerce store

Step 1- Go to "Apps" in your Eshopbox workspace. Search for "Woocommerce" and click to install it in your workspace

Open

Step 2- Enter the StoreId of the woocommerce store and click on connect:

Open

User will enter the store-Id as mentioned in placeholder. Once he enter and click on connect, the authentication URL we be created by picking the store URL mentioned in input field:

1. Following URL will be called internally to initiate the connection between WooCommerce and Eshopbox:

Request Params for authentication url:

2. Upon calling the authentication URL, you will be redirected to a page for authorization as shown below:

   1. If user has clicked on Approve and gets authencticated- Redirection to return-url with appending success param’s as : success=1&user_id=electronicsell

   2. If user has clicked on Deny , unathenticated- Redirection to return-url with appending success param’s as : success=0&user_id=electronicsell

Open

3. Once the user click on approve woocommerce will internally call the specified callback_url and pass the following body to callback url:
   
   

   { "key_id": 1, "user_id": 123, "consumer_key": "ck_xxxxxxxxxxxxxxxx", "consumer_secret": "cs_xxxxxxxxxxxxxxxx", "key_permissions": "read_write" }

    

4. Cases to check before establishing a successful connection and saving consumer key and consumer secret in DB.

   1. Before building a connection we have to check currency value once we received the consumer key and consumer secret on callback URL using those credentials we have to call currency check API:

      https://woo-briskly-different-dinosaur.wpcomstaging.com/wp-json/wc/v3/settings/general/woocommerce_currenc

      1. Response
         
         

         { "id": "woocommerce_currency", "label": "Currency", "description": "This controls what currency prices are listed at in the catalog and which currency gateways will take payments in.", "type": "select", "default": "USD", "options": { "AED": "United Arab Emirates dirham (د.إ)", "AFN": "Afghan afghani (؋)", "ALL": "Albanian lek (L)", "AMD": "Armenian dram (AMD)", "ANG": "Netherlands Antillean guilder (ƒ)", "AOA": "Angolan kwanza (Kz)", "ARS": "Argentine peso ($)", "AUD": "Australian dollar ($)", "AWG": "Aruban florin (Afl.)", "AZN": "Azerbaijani manat (₼)", "BAM": "Bosnia and Herzegovina convertible mark (KM)", }, "tip": "This controls what currency prices are listed at in the catalog and which currency gateways will take payments in.", "value": "INR", "group_id": "general", "_links": { "self": [ { "href": "https://mayurkarwa123.wpcomstaging.com/wp-json/wc/v3/settings/general/woocommerce_currency" } ], "collection": [ { "href": "https://mayurkarwa123.wpcomstaging.com/wp-json/wc/v3/settings/general" } ] } }

          

      2. If value=='INR', then success

      3. if value !='INR' then throw error- “Error in connecting Woocommerce store. Please check your currency value in woocommerce store“

   2. check the read_write access for that when we receive the callback_url hit we can check the key_permissions key and its value which should be read_write if its not read_write is something else then that please throw error:
      Error in connecting Woocommerce store. Please check the read write permission.

   3. If the two check are successful then,
      Success message - Your Woocommerce store is successfully connected with Eshopbox.

5.  

   1. Unique URL:

      • If the entered Woocommerce store URL is not unique across all Eshopbox workspaces, display an error message.

        • Error Message: "This store URL is already connected with Eshopbox in a different workspace. Please disconnect before trying to connect it in this workspace."

        • In case it is in the same workspace, the Error message: "This store URL is already connected with your Eshopbox workspace"
          
          

Note:-