How to Integrate Square POS

How to integrate your Square POS with WISK

Nick Neale avatar
Written by Nick Neale
Updated over a week ago

Article Contents

Step 1 - Select Square as POS Type

  1. On the WISK Web Portal, hover your cursor over your user icon on the bottom left, then click "Venue Settings"

    The Venue Setting button is highlighted for emphasis.
  2. Click "Edit" beside POS Type

    The "Edit" button is highlighted for emphasis.
  3. In the window that opens, click the “POS Type” drop-down menu, and select Square

    An arrow points to click the drop-down menu in the POS Type field.
  4. The window updates and you'll see a few options, but for now click “Set up” to continue

    An arrow points to the "Set up" button.

Note: This opens Square's login page in a new window. If nothing appears, please temporarily disable your browser's pop-up blocker and try again.

STEP 2 - Log-in to Square Account

  1. A new tab opens in your browser on the Square Web Dashboard. type your Square username and password and click “Sign In"

    The Square sign in screen.
  2. The integration process works behind the scenes to link WISK with your Square account. When complete, it displays:

{
"success": true
}

Note: If you receive a different message, please contact WISK Support.

STEP 3 - Select Venue(s)

After your Square account is connected to WISK, you'll need to select the venue you want to import sales from.

If your Square account has more than one location, you can choose which venues to import sales from by clicking the checkboxes in the table.

The table on the POS Type window that shows all the locations is highlighted for emphasis.

Note: If you don't select any of the locations, no sales will be imported into the venue.

STEP 4 - Customize POS Items (Optional)

Before your sales data is imported, you can customize how your sales data / POS Items appear in WISK.

With Square, you have the following customization options:

  • Include all POS Items even if not sold - By default, WISK only imports items with sales. If you create a new item in your POS, it won’t appear as a POS Item in your account until it is sold. If you check this box, it will appear as a POS Item before it is sold, and can be mapped.

    Note: If you have a large number of historical items in your POS, checking this option may create lots of POS Items.

  • Import Modifiers as Separate POS Items - When you select this option, your modifiers for items will appear as separate POS Items. For example, if you sell a Tito's Vodka Single and you use modifiers to track the mix that it is sold with, it will appear differently depending on whether this box is checked. Lets say we sell it with Orange Juice:

    • Checked - There will be a separate POS Item for "Tito's Vodka Single", and for "Orange Juice". Orange Juice could be used as a modifier in multiple items, and it will only appear as one POS Item.

    • Unchecked - There will be a combined POS Item of "Tito's Vodka Single - Orange Juice".

    Note: Choosing to check this box will depend on the way you have set up your menu items and how you use modifiers.

If you select any of the above options and your POS Items didn't populate the way you expected, you can change your customizations options at any time by accessing the "Venue Settings". To learn more, see "Clear Previous Sales Data"

STEP 5 - Saving the Integration

After selecting the venues/locations and customization options, click "Save".

The "Save" button is highlighted for emphasis.

By default, WISK pulls your last six months of sales data. If you have items in your POS that have not been sold in the past six months, they will not appear in your POS Items from the initial sales pull (unless you checked to include all POS Items even if not sold in Step 5).

This is to reduce the amount of POS Mapping that you have to do at the onset.

Those items will appear in your POS Items the next time they are sold.

If you encounter any errors during the integration process, or your sales data isn’t appearing after 24 hours, please reach out in the chat or email [email protected].

Clear Previous Sales Data

If you have imported your sales data, but realized the settings aren't displaying your POS Items and modifiers the way you want, you can make changes.

You can clear all previous sales data by clicking the “Clear Previous Data” button.

An arrow points to the "Clear previous data' button on the POS Type window

This button:

  1. Deletes all sales data from the venue

  2. Keeps all mapped POS Items

  3. Removes all unmapped POS Items

You can then click the “Save” button with your new settings and it re-imports all of your sales data based on what you’ve selected.

Note: To reduce the amount of required effort, it’s best to customize your sales data after integrating and before POS mapping begins.

Expired Authentication Token

The integration with Square requires an authentication token that is generated during setup. Some events can cause the token to expire (Square updating their API version) which disables the integration.

If this happens, you'll receive a notification on web.wisk.ai and an email saying the token has expired. To re-integrate, just go through the setup process again to generate a new token.

The notification that appears when the authentication token expires
The email that goes out when the token is expired directing users to web.wisk.ai

Did this answer your question?