Webshop integration

Server-side tracking for Square

ROASaurus reads paid orders from Square Online and your Square POS through the Orders API and sends them to your ad platforms from the server.

Square at a glance
Orders arrive byOrder webhooks, plus a check every 5 minutes
CredentialsConnect with Square, or an access token from your own Square developer app
Paid ordersCompleted orders, and open orders with nothing left to pay
Customer dataEmail, name and address from the Square customer profile

How Square connects

  1. Add the ROASaurus script to your Square Online site, where your plan allows custom code.
  2. Press Connect with Square on the Connection page and approve read access to orders, customers and locations. You can also paste an access token from your own Square developer app and add a webhook subscription to your ROASaurus webhook URL.
  3. ROASaurus checks all your locations every 5 minutes and catches anything a webhook missed.

What ROASaurus reads from each order

The total and currency, the reference or ticket name, the customer's email, name, phone and address from their Square profile or the fulfillment recipient, and each line item's variation, quantity and price.

Limits

  • POS orders without a customer profile carry no email or phone, so they count in revenue and profit but are hard to match to an ad click.
  • Square orders include no IP address. Square Online purchases are matched through the script and an email the visitor gave earlier.
  • The connector is built from the platform's official API documentation. Press Test connection after saving your credentials, then place a test order and check the Event log.

Related

FAQ

Questions, answered

Does it include in-store POS sales?

Yes. ROASaurus reads orders from all your Square locations, so POS sales count in revenue, profit and LTV.

Which permissions does ROASaurus ask for?

Read access to orders, customers and locations. ROASaurus cannot change anything in your Square account.

Every sale, traced to the ad that earned it

Server-side tracking, profit and lifetime value in one app. Free plan, no credit card.

Start free →