# 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](#permissions-granted-to-violet) 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.