Square

This guide is intended for Square merchants who are connecting their store to Violet. During the connection process, you will be redirected to Square to authorize the Violet application. Upon completion, Square will automatically provide Violet with the access tokens required to sync with your store. Total time for completion is around 2 minutes.

Prerequisites

Your Square account must have at least one active location configured. Violet uses your primary location to identify your store and populate your shop profile.

Step 1: Begin the Connection

1. From Violet Connect, select Square as your platform.

2. Click Continue. You will be redirected to Square's authorization page.

Step 2: Authorize Violet

1. Log in to your Square account if prompted.

2. Review the permissions that Violet is requesting (see Permissions below).

3. Click Allow to grant Violet access to your store.

Upon authorization, Square will redirect you back to Violet Connect and your store will be fully connected.

Upon success you will be redirected back to the channel who first sent you to Violet.

Permissions Granted to Violet

During the authorization process, Violet requests the following permissions from your Square account:

Permission	Purpose
ORDERS_READ	Read orders placed through Violet to track fulfillment status.
ORDERS_WRITE	Create and update orders in your Square account when a purchase is made.
ITEMS_READ	Read your product catalog to make your items available for purchase.
CUSTOMERS_READ	Read customer data associated with orders.
MERCHANT_PROFILE_READ	Read your merchant profile and location information to identify your store.

Access Token Refresh

Square access tokens expire every 30 days. Violet automatically refreshes your access token in the background using the refresh token obtained during the initial authorization. No action is required on your part to maintain your connection.