> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veroreceipts.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

Vero integrates with Square POS to automatically deliver encrypted, itemized digital receipts to your customers' banking apps. Setup takes less than 30 seconds.

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

## Quick Start

<Steps>
  <Step title="Authorize Integration">
    <Card title="Install the Vero Plugin" icon="square" href="https://api.veroreceipts.com/square/oauth/authorize">
      This link will direct you to the official Vero / Square plugin.
    </Card>
  </Step>

  <Step title="Confirm Permissions">
    Ensure you are logged in, review the requested Square permissions, and authorize access.

    <img alt="Square Plugin" lightAlt="Square Plugin" darkAlt="Square Plugin" src="https://mintcdn.com/vero-80b6ce5c/FWA4F71E3s1giCWk/images/vero_auth.png?fit=max&auto=format&n=FWA4F71E3s1giCWk&q=85&s=9fb34b7291b05a882669adc15359ce81" className="dark:hidden" width="1374" height="1014" data-path="images/vero_auth.png" />

    <img alt="Square Plugin" lightAlt="Square Plugin" darkAlt="Square Plugin" src="https://mintcdn.com/vero-80b6ce5c/oaZyhCyD8xIeRVDv/images/square.png?fit=max&auto=format&n=oaZyhCyD8xIeRVDv&q=85&s=7035735687c04be34c8d25c457bc7b5c" className="hidden dark:block" width="1462" height="960" data-path="images/square.png" />
  </Step>

  <Step title="Start Sending Receipts">
    That's it. Vero automatically sends encrypted receipts for all transactions to customers whose banks support digital receipts.
  </Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="Does this cost anything?">
    No. Vero is completely free for merchants. Banks pay for the service because digital receipts reduce their fraud dispute costs.
  </Accordion>

  <Accordion title="Does this 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.
  </Accordion>

  <Accordion title="Do customers need to do anything?">
    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).
  </Accordion>

  <Accordion title="Will my customers know receipts are coming from my business?">
    Yes. Your business name from your Square merchant profile appears on all digital receipts.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="How quickly do customers receive digital receipts?">
    Digital receipts typically appear in customers' banking apps within 1-2 seconds of transaction completion.
  </Accordion>
</AccordionGroup>

## Support

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