# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://merchant-help.violet.io/platform-guides/square.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.