> ## Documentation Index
> Fetch the complete documentation index at: https://zuperinc-section23.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Square

**Square** is a popular point-of-sale (POS) system that enables merchants to accept credit and debit card payments through a mobile app or card reader. Known for its simple setup, quick deposits, and affordable transaction fees, Square is now integrated with **Zuper**, allowing you to collect full or partial payments for estimates and invoices directly from the app.

### A. Connecting Your Square Account

To connect your Square account, follow these steps:

1. **Log in** to your Square Developer Dashboard at [https://developer.squareup.com/apps](https://developer.squareup.com/apps).

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square4.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=9ec1ee7a46438d84a96d503325c6772c" alt="Square4 Pn" width="1899" height="843" data-path="images/square4.png" />

2. **Create a new developer application.**
   * Once created, you can find your **App ID** on the application details page.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square5.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=0d4931705f00a4746b37e29ba69e3566" alt="Square5 Pn" width="3088" height="1818" data-path="images/square5.png" />

3. **Generate an Access Token** from your **Sandbox** or **Production** environment.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square6.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=856af7b6f92586b85a3e623eb6742b75" alt="Square6 Pn" width="3092" height="1812" data-path="images/square6.png" />

4. **Locate your Location ID** from the **Locations** page.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square7.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=01737bf0f8c068b7b9818f7d586ef926" alt="Square7 Pn" width="3088" height="1822" data-path="images/square7.png" />

You will need the following three values to configure the integration in Zuper:

* **App ID**
* **Access Token**
* **Location ID**

### B. Integrating and Using Square with Zuper

#### I. How to Connect Square with Zuper

1. Log in to your **Zuper account**.
2. Click your **Profile Picture** (top-right corner) and select **App Store**.

<img src="https://mintcdn.com/zuperinc-section23/WjkgYG1dYygIdKBT/images/Appstore.jpg?fit=max&auto=format&n=WjkgYG1dYygIdKBT&q=85&s=858065d0246f4ac96c022cbb673a6f86" alt="Appstore Jp" width="1903" height="872" data-path="images/Appstore.jpg" />

3. Under **Browse by Category**, choose **Accounting & payments** → select **Square**.

<img src="https://mintcdn.com/zuperinc-section23/HaYVJQyRqHRtd36c/images/Square.png?fit=max&auto=format&n=HaYVJQyRqHRtd36c&q=85&s=9983fd67a352aadeb9b55b0faf928f39" alt="Square Pn" width="1875" height="782" data-path="images/Square.png" />

4. Click **Configure Settings**.

<img src="https://mintcdn.com/zuperinc-section23/HaYVJQyRqHRtd36c/images/Square1.png?fit=max&auto=format&n=HaYVJQyRqHRtd36c&q=85&s=f03a5d442e3fb8fcea31f34d0cd231a9" alt="Square1 Pn" width="1864" height="751" data-path="images/Square1.png" />

5. Fill in the configuration fields:

   |           **Field**           |                                                **Description**                                                |
   | :---------------------------: | :-----------------------------------------------------------------------------------------------------------: |
   |     **App ID (Mandatory)**    |                            Enter the App ID from your Square Developer Application.                           |
   |  **Access Token (Mandatory)** |                               Enter the Access Token from the Credentials page.                               |
   |  **Location ID (Mandatory)**  |                             Enter the Location ID from your Square Locations page.                            |
   | **Zuper API Key (Mandatory)** | Enter your Zuper API key. [Learn how to generate it.](https://developers.zuper.co/reference/generate-api-key) |
6. Click **Update** to connect your Square app with Zuper.

<img src="https://mintcdn.com/zuperinc-section23/HaYVJQyRqHRtd36c/images/Square2.png?fit=max&auto=format&n=HaYVJQyRqHRtd36c&q=85&s=25dee536b70b44957ee092f7d58a206d" alt="Square2 Pn" width="1526" height="731" data-path="images/Square2.png" />

<Note>
  Note: Ensure that the Zuper API key is linked to a dedicated account for smooth integration.
</Note>

#### II. How the Zuper–Square Integration Works

Zuper integrates with Square to collect payments for **Jobs**, **Estimates**, and **Invoices**.

<Frame>
  **Navigation**: Accounting → Quotations → Collect Deposit

  Accounting → Invoices → Payment
</Frame>

**To collect a payment:**

1. Go to the **Quotes** module from the top-left menu.
2. Select the quote for which you want to collect a payment.
3. Click **Collect Deposit** → select **Credit/Debit Card**.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square8.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=7db65763579e20bc2b4d13c7658dfdf6" alt="Square8 Pn" width="1480" height="2740" data-path="images/square8.png" />

4. If the customer’s card is saved, you’ll see it listed. Otherwise, select **Add New Card**.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square9.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=9b09dcd14e9bfa2f3b8c7b5352d2c0fe" alt="Square9 Pn" width="1480" height="2740" data-path="images/square9.png" />

5. After entering new card details, the customer will be prompted to either:
   * **Skip** (proceed to payment directly), or
   * **Save and Pay** (save the card for future transactions).

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square10.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=81b3500fe65f23a6b6a1b298789ab905" alt="Square10 Pn" width="1480" height="2740" data-path="images/square10.png" />

<Note>
  Note: The same process applies when collecting payments for invoices.
</Note>

With Square integrated, customers can securely pay and sign using the merchant’s mobile device, while merchants can process credit card payments effortlessly.

### C. Uninstalling the Integration

You can uninstall the integration from either **Zuper** or **Square**.

#### I. Uninstall Square from Zuper

1. Log in to your **Zuper account**.
2. Click your **Profile Picture** → select **App Store**.
3. Under **Accounting and Payments**, select **Square**.
4. Click **Deactivate**.

<img src="https://mintcdn.com/zuperinc-section23/HaYVJQyRqHRtd36c/images/Square3.png?fit=max&auto=format&n=HaYVJQyRqHRtd36c&q=85&s=03ed8e24082d2b2d34a7e21f45e19506" alt="Square3 Pn" width="1526" height="731" data-path="images/Square3.png" />

The Square integration will be deactivated successfully.

#### II. Uninstall Zuper from Square

1. Log in to your **Square account**.
2. Navigate to **Settings → App Integrations**.
3. Next to **Zuper**, click **Manage** to open the developer console: [https://developer.squareup.com/console/en/apps](https://developer.squareup.com/console/en/apps).
4. From the left menu, select **OAuth**.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square11.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=a48ee33e993714b454a2bb1e6e838bd8" alt="Square11 Pn" width="1863" height="835" data-path="images/square11.png" />

5. Click **Replace Secret** to regenerate your **Application Secret**.

<img src="https://mintcdn.com/zuperinc-section23/4f4X5JBG5RSD0AHv/images/square12.png?fit=max&auto=format&n=4f4X5JBG5RSD0AHv&q=85&s=3023dd2a0081d56fd00e4b3eafc42d0a" alt="Square12 Pn" width="1863" height="835" data-path="images/square12.png" />

6. Return to **App Integrations**, click the **ellipsis (⋮)** icon next to Zuper, and select **Disconnect**.

Zuper will now be successfully disconnected from your Square account.

Once connected, the **Zuper–Square Integration** allows you to:

* Accept secure payments for estimates and invoices.
* Save customer cards for future use (with consent).
* Manage payments seamlessly from the Zuper mobile or web app.