Skip to main content

Square

Available

This integration is available in Frihet. Configure it in Settings → Integrations → Square.

Connect your Square account to Frihet to automatically import your point-of-sale transactions and payments. Square is a payment platform that includes POS terminals, online payments, and inventory management. With this integration, each sale registered in Square is imported into Frihet as revenue, eliminating manual entry and keeping your accounting synchronized with in-person and online sales.

What does it do?​

  • Import transactions — Each payment processed in Square (POS, online, invoice) is imported as revenue into Frihet with all details
  • Automatic reconciliation — Cross-reference Square payments with your invoices in Frihet without manual effort
  • Synchronized clients — Clients registered in Square are imported into your contact database in Frihet
  • Fees as expenses — Fees charged by Square for each transaction are automatically recorded as expenses in Frihet
  • Complete history — Import past transactions to get a comprehensive view of your business activity

Requirements​

  • Active account on Square
  • Frihet Pro or Business plan
  • Square API Access Token (obtained from the Square Developer Dashboard)

How to connect​

Step 1: Obtain your Access Token in Square​

  1. Log in to developer.squareup.com
  2. Create a new application or select an existing one
  3. In the application dashboard, navigate to Credentials
  4. Copy the Production Access Token (do not use the sandbox token for real data)
  5. Ensure the token has read permissions for Payments, Orders, and Customers

Step 2: Configure in Frihet​

  1. In Frihet, go to Settings → Integrations
  2. Find Square and click on the card
  3. Paste your Access Token into the corresponding field
  4. Click Test connection to verify that the credentials are correct
  5. Select the Square location you want to synchronize
  6. Click Save

Data that is synchronized​

DataDirectionDetails
Transactions/paymentsSquare → FrihetAmount, date, payment method, reference
ClientsSquare → FrihetBuyer name, email, phone
FeesSquare → FrihetSquare fees recorded as expenses
Products soldSquare → FrihetDetail lines for each transaction
Payment statusSquare → FrihetCompleted, refunded, pending

Use cases​

Physical store with digital accounting​

You have a store and charge with the Square terminal. Each day's sales are automatically imported into Frihet overnight. Your accounting reflects all in-person sales without you having to manually copy anything. Square fees appear as expenses so you can see your real margin.

Business with in-person and online sales​

You sell both in-store with Square and through your website. Frihet consolidates Square transactions with your online invoices to give you a unified view of all your revenue. You can generate tax reports with all revenue sources centralized.

Freelancer with mobile payments​

You are a freelancer and charge your clients with Square on your mobile (events, home services, markets). Each payment is automatically recorded in Frihet with service details, so your accounting is up-to-date without extra time.

Troubleshooting​

Connection error​

  • Verify that you are using the Production Access Token, not the sandbox one
  • Check that the token has not expired or been revoked from the Developer Dashboard
  • Ensure that the Square application has the necessary permissions (Payments Read, Orders Read, Customers Read)

Transactions are not imported​

  • Confirm that you have transactions within the selected date range
  • Only transactions with completed status are imported — pending or canceled ones are excluded
  • Verify that you have selected the correct Square location

Duplicate transactions​

  • Frihet deduplicates by Square transaction ID. Duplicates should not occur
  • If you see duplicates, disconnect and reconnect the integration
  • Transactions already imported into Frihet are not affected by reconnection

Fees not recorded​

  • Fees are recorded as separate expenses, they are not deducted from the transaction amount
  • Verify that fee import is activated in the integration settings

Next steps​