Live

Square POS Transaction Analytics

Connect point-of-sale data to spatial intelligence

Get Started API Docs

15sRefresh Rate

~50KData Points/Day

<80msNormalization

9API Fields

How It Works

Square to AI in three steps

The Problem

Square tracks every transaction but can't tell you how foot traffic correlates with revenue. Combining POS data with occupancy analytics reveals the full picture of venue performance.

The Solution

Real-time transaction ingestion via Square OAuth2 API
Revenue per occupied seat and conversion rate analytics
Item-level sales trends correlated with occupancy
Payment method and customer profile analytics
Multi-location revenue comparison dashboards

Data Explorer

What Data You Get from Square

Every field below is normalized into the GuestNetworks canonical schema and available via REST API and MCP tools.

Field Name ↑	Type	Description	Example
created_at	string	ISO timestamp of transaction	2024-03-22T14:30:00Z
customer_id	string	Square customer profile ID	cust_V2K8xP
employee_id	string	Employee who processed the sale	emp_A1B2C3
id	string	Unique transaction identifier	txn_8kLm2nR4pQ
line_items	array	Individual items in the transaction	[{"name": "Latte", "quantity": "2"}]
location_id	string	Square location identifier	loc_L1M2N3
tender_type	string	Payment method used	CARD
total_money.amount	number	Transaction amount in cents	4250
total_money.currency	string	ISO currency code	USD

Live Preview

This is what your AI agent sees

Every Square event is normalized into this canonical JSON structure. One schema, any connector.

gn_canonical_event.json

{
  "event_type": "transaction",
  "connector": "square",
  "venue_id": "ven_5j8k2m",
  "timestamp": "2024-03-22T14:30:00.000Z",
  "data": {
    "transaction_id": "txn_8kLm2nR4pQ",
    "amount_cents": 4250,
    "currency": "USD",
    "items": [
      {
        "name": "Oat Milk Latte",
        "quantity": 2,
        "amount": 1200
      },
      {
        "name": "Avocado Toast",
        "quantity": 1,
        "amount": 1850
      }
    ],
    "tender_type": "CARD",
    "location": "Downtown Cafe"
  },
  "metadata": {
    "normalized_at": "2024-03-22T14:30:00.008Z",
    "schema_version": "1.0"
  }
}

Data Types

What You Get

Transactionsitem salespayment methodscustomer profiles

Visualizations

Built-in Chart Types

Every integration unlocks these dashboard visualizations. No configuration needed.

Revenue Over Time

Transaction volume and revenue trends by hour and day

Traffic-to-Transaction Funnel

Conversion rate from foot traffic to completed purchases

Payment Method Breakdown

Distribution of card, cash, and digital payment types

Revenue per Occupied Hour

Revenue correlated with occupancy for true performance

Quick Start

Get your Square data in 60 seconds

Four steps from zero to live data. Your credentials are encrypted with AES-256-GCM at rest.

Create a Square application

Go to Square Developer Dashboard > Applications. Create an app and get your access token.

Create a GuestNetworks account

Register Square integration

POST your Square access token and location ID.

curl -X POST https://api.guestnetworks.com/api/venues/:id/integrations \
  -d '{"connector_type": "square", "config": {"access_token": "...", "location_id": "loc_L1M2N3"}}'