Multi-vendor Marketplace for Shopify: SquareUp Connector

• Sellers can connect their Square POS to the admin’s Shopify store.
• Auto-Sync Option:- To sync all the newly added products of the seller’s Squareup store will be auto-synced with the admin’s Shopify store.
• Option to re-sync the products from the product listing section.
• Allow sellers to create price rules:- Based on the product price rules created by the seller, the product price of Square up POS will be calculated at the merchant’s store.
• Marketplace sellers can import their Square POS products to the admin’s store.
• The sellers can now have multiple variant options in a product synced from Squareup into the multi-vendor marketplace app.

Go to the Feature app section and enable the Squareup connector feature app.

Visiting the feature App section, search for the Squareup Connector & enable the feature app.

After enabling the Squareup feature app, a new menu appears under the Configuration menu i.e. Squareup App Configuration. You need to configure the Squareup app details for the seller’s Squareup store.

Visiting this section, you will get the options to enter the details of the app that you have created on Squareup for your sellers.

Now, in order to let the sellers connect their Squareup stores to your Shopify store, you need to Create an App on Squareup. From the app, you will get the credentials that are required to configure the app settings & make things work for the sellers.

You can create an app on your own or request to create the app.

You can follow the below-given steps to create an app on Square up:-

• Log in to Squareup.
• Go to the Dashboard and click on + button to add a New Application.

• Now, enter the Application Name & click the Save button.

This way, you can create an application on Squareup.

Now, enable the Production mode settings and get the credentials to configure Squareup settings on the multi-vendor app.

Note

Make sure to change the API Version suggested in the app. You need to click the Change Version button & select the version: (2019-09-25)

Clicking the version, you can select the version (2019-09-25) from the drop-down menu.

This way, you can end up creating an app on Squareup. Now, you need the app credentials to configure the square up settings for your sellers on the multivendor app.

After creating the Squareup app, all the credentials will be available to configure the settings. Let’s see how to get each of them.

1. Application ID
   Go to Dashboard>>Visit Squareup App>>View Details>>Credentials.

2. Application Secret
Go to Developer >>Visit Squareup App>>View Details>>OAuth.

3. Webhook Signature Key
To get the Signature Key, first, you need to create a webhook. Let’s see how to do that.

You need to register a webhook to get triggered by specific events that occur on the seller’s Square POS.

APIs require calls at regular time intervals in order to detect changes in data. Thus, webhook replaces these API calls & provides instant, real-time notification updates on specific events that occur at the seller end (on Square POS).

For more details, Click here

So, let’s see how to create a webhook.

Creating a webhook will provide you the signature key to configure the Squareup app details for sellers in the Multi-vendor App. To get the hit, perform the below-given steps & add a webhook:-

• Log in to Squareup.
• Visit the Squareup Dashboard.
• Go to Apps.
• If you have created an app, go to My Apps.
• Go to Developer Dashboard.
• Click View Details of the app you have created.
• You will be redirected to the Credentials section from where you need to visit the Webhook section.
• Enable Webhook.

• Now, proceed to Connect v2 Webhooks.
• Click the Add Endpoint.
• Here, You need to enter the Webhook name, Webhook Listener URL (provided in the app), set the API version (2019-09-25).
• Select the two events:-
  catalog.version.updated
  inventory.count.updated
• Save.

• This way, you can end up creating a Webhook. Now, click the Save button to save the created Webhook.

Thereafter, you will get the Webhook Signature Key, required to configure the Squareup details for sellers in the multi-vendor app.

Click the name of the created Webhook & get the signature key from there.

Get the Webhook Signature Key from here.

With these details, you can configure the Squareup settings in the app and allow sellers to connect their Squareup shop with the admin’s Shopify store.

Details Saved Successfully:-

Now, let’s proceed to check the functionalities on the Seller end.

As soon as the admin enables the Squareup feature, a new sub-menu gets added to the Configuration menu of the app i.e. Squareup Configuration.

Visting the Squareup Configuration menu, firstly, the seller needs to install the Squareup App (that is already developed at the time of integration of Squareup with the Multi-vendor Marketplace app).

Seller will click the Download Shopify-Squareup App. This will redirect the seller to the login page of the Squareup.

Clicking the above button, the seller will be asked to log in to the Squareup store. If already logged in, subsequently, the seller will be redirected to the Squareup permission page. The seller needs to allow access.

Now, the seller will log in to his/her Squareup store and allow access.

Coming back to the seller panel, the seller will configure the settings such as enable the auto-sync option, change weight unit, map collections, etc.

Auto-sync New Products

The sellers can enable this option to auto-sync the newly added products to the admin’s Shopify store.

Moreover, the seller will click the import products button to import previously added Squareup store products to the admin’s Shopify store.

Before the product import, the seller needs to map the admin’s store collection with the collections of his/her Squareup store.

Note:- Make sure that the admin has enabled the “Restrict Collection” tab from the multi-vendor admin panel.

For this, the seller will visit the Map Collection section and then, select the admin’s collection to map with his/her own Squareup store’s collection.

Seller will choose the admin’s store collection & map it with Squareup store’s collection.

Finally, all the mapped collections will be listed like this:-

This way, sellers can map collection.

After all these settings, the seller will proceed to import products from his/her Squareup store to the admin’s Shopify store. Clicking the Import Product button, the seller will enter the comma-separated product IDs (that the seller wants to import).

Please note: You can only import “simple” and “variable“ products.

This way, the seller can import Squareup products to the admin’s Shopify store.

Sync with Seller’s Store

In case the products are not synced once you import them, you can visit the seller listing section & sync products with the seller’s store.

Products>>>Product Listing>>>Action menu>>>Click “Sync with seller store” button.

Let the sellers create price rules to manage the product price of the seller’s Square up POS to the merchant’s store.

Sellers will have a new menu named Connector Price Rule in the configuration menu of the app. From here, the seller can create price rules based on which the seller’s product price will be calculated on the merchant’s store. 

Clicking the Connector Price Rule, afterward, the seller needs to enable “Price Rule” status and select the options as increase/decrease price, the price will be changed by a fixed amount or a percentage amount, enter the amount that needs to be changed.

Enable the checkbox to update the already synced product’s price at the merchant’s store as per the price rule created.

As shown above, through this way, sellers can create price rules from their respective seller panels based on which product price of the seller’s POS will be calculated at the merchant’s store.

Sync Orders

Orders can now be created in Seller’s Squareup through the Squareup Connector feature app.

You can choose if you want to create an order on the seller’s Squareup Store or not. For this, you need to visit the admin panel>>Connector Configuration>>Enable Sync Order tab.

As soon as you enable this tab, you will get the option to choose if you want to sync customer data related to the order or not.