> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veromerchants.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Square POS Integration

> Install Vero on Square POS, Square Register, and Square Terminal

## Overview

Connect Square POS to Vero and your catalog and line-item sales come in as the terminal closes each sale. That data powers [Pricing Intelligence](https://docs.veromerchants.com/products/pricing-intelligence.md), [Customer Insights](https://docs.veromerchants.com/products/customer-insights.md) and the storefront on your [AI Builder](https://docs.veromerchants.com/products/ai-builder.md) site. Setup takes less than 30 seconds.

> [!NOTE]
>
> **Digital receipts come included.** Once Square is connected, Vero also sends an encrypted, itemized copy of each receipt to your customers' banking apps. Customers recognize the charge, which means fewer chargebacks and friendly fraud disputes. [Learn more](https://docs.veromerchants.com/digital-receipts/overview.md).

> [!NOTE]
>
> To see a list of official Square merchants, see this resource: [https://giveandgetlocal.com](https://giveandgetlocal.com)

## Quick Start

**1. Authorize Integration**

> **[Install the Vero Plugin](https://api.veromerchants.com/square/oauth/authorize)**
>
> This link will direct you to the official Vero / Square plugin.

**2. Confirm Permissions**

Ensure you are logged in, review the requested Square permissions, and authorize access.

![Square Plugin](https://mintcdn.com/vero-80b6ce5c/FWA4F71E3s1giCWk/images/vero_auth.png?fit=max\&auto=format\&n=FWA4F71E3s1giCWk\&q=85\&s=9fb34b7291b05a882669adc15359ce81)

**3. Start Sending Receipts**

That's it. Your sales start syncing to Vero, and encrypted receipts go out to customers whose banks support digital receipts.

## Required Permissions

Vero requests the following Square permissions:

* **View your payments history** - Transaction amounts and timestamps
* **View your Square orders** - Itemized receipt data
* **View your invoice information** - Detailed line items
* **View your merchant profile information** - Business name for receipts

## Data Structure

When a transaction occurs, Vero receives the following data from Square:

```json theme={null}
{
  "merchant_id": "MLQW4HSGFQK3E",
  "location_id": "L6C9K3D8TMWQE",
  "payment": {
    "id": "KkAkhdMsgzn59SM8A89wQFLPxY4F",
    "amount_money": {
      "amount": 1850,
      "currency": "USD"
    },
    "created_at": "2025-01-16T22:15:30Z",
    "card_details": {
      "card": {
        "last_4": "1234",
        "card_brand": "VISA"
      }
    }
  },
  "order": {
    "id": "CAISEDk3MzQxZGM4LWE3MGYtNDA",
    "line_items": [
      {
        "name": "Latte",
        "quantity": "1",
        "base_price_money": {
          "amount": 495,
          "currency": "USD"
        }
      },
      {
        "name": "Blueberry Muffin",
        "quantity": "2",
        "base_price_money": {
          "amount": 450,
          "currency": "USD"
        }
      }
    ],
    "total_money": {
      "amount": 1850,
      "currency": "USD"
    }
  }
}
```

This data is immediately encrypted and transmitted to participating banks for delivery to customers.

## Privacy & Security

**Your transaction data is never exposed.** All receipt data is encrypted using RSA-2048 encryption before leaving your Square account. Only your customers hold the private keys to decrypt their own receipts.

* Vero cannot read your transaction data
* Banks cannot read your transaction data
* Only the customer who made the purchase can decrypt their receipt

Transaction data is encrypted client-side and transmitted directly to the customer's bank in encrypted form. No intermediary ever has access to unencrypted receipt information.

## FAQ

> **Does this cost anything?**
>
> No. Connecting your POS is free on the Starter plan, with no hardware and no contract. Starter includes Pricing Intelligence and digital receipts. AI Builder and Customer Insights come with the Custom plan. See [pricing](https://veromerchants.com/pricing).

> **Do digital receipts replace email/SMS receipts?**
>
> No. Vero receipts are in **addition** to your existing receipt methods. Customers still get email/SMS if configured. Vero sends an encrypted copy to their bank.

> **Do customers need to do anything to get digital receipts?**
>
> Customers must have:
>
> 1. A card from a Vero-enabled issuer
> 2. Digital receipts enabled in their banking app
>
> If either condition isn't met, they won't receive Vero receipts (but will still get email/paper receipts).

> **Will my customers know receipts are coming from my business?**
>
> Yes. Your business name from your Square merchant profile appears on all digital receipts.

> **Can I see what customers see?**
>
> No - receipts are encrypted with each customer's private key. Only they can decrypt and view the receipt in their banking app. You can see delivery confirmation but not the decrypted content.

> **Does this work for online Square orders?**
>
> Yes! The integration works for:
>
> * In-person Square POS/Register/Terminal
> * Square Online Store checkout
> * Square Invoices
> * Square Virtual Terminal
>
> Any card-present or card-not-present transaction sends a Vero receipt.

> **What about refunds and voids?**
>
> Refunds automatically trigger an updated receipt showing:
>
> * Original items
> * Refund amount
> * Refund date/time
> * Updated balance
>
> Voided transactions don't send receipts.

> **Can I disconnect at any time?**
>
> Yes. You can revoke Vero's access through your Square account settings at any time. Go to **Account & Settings > Business > Integrations** in your Square dashboard.

> **How quickly do customers receive digital receipts?**
>
> Digital receipts typically appear in customers' banking apps within 1-2 seconds of transaction completion.

## Support

Questions? Contact [hi@veromerchants.com](mailto:hi@veromerchants.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.