Payments

Fynso + Square: POS, Payments, and Payouts in Your Daily Brief

Fynso connects to Square through OAuth and reads merchant profile, bank accounts, customers, items, orders, payments, payouts, settlements, invoices, subscriptions, and dispute data. The connection feeds Fynso's cash forecast with real payout timing, surfaces processor fee drag, and flags failed payments and disputes early. The standard sync is read-focused. Setup takes about two minutes.

Read-focused sync — writes require explicit approval

What this integration unlocks

  • Payout and settlement-aware forecast

    Square payouts and settlements have well-defined timing patterns. Fynso reads them directly and projects them into the 30/60/90-day cash forecast — sharper than waiting for funds to clear the bank.

  • Processor fee drag analysis

    Square processing fees tracked as a percentage of revenue over time. The brief flags when fees are creeping up or when specific charge types (keyed-in, premium cards) are eating more margin.

  • Order and revenue mix visibility

    For businesses with multiple revenue lines (different services, product categories, or locations), Square order data feeds margin and mix analysis in the monthly brief.

  • Customer concentration and repeat-visit signals

    Square customer data shows who's coming back, who's drifted, and which customer segments drive revenue concentration.

  • Failed payment and dispute surfacing

    Failed charges and disputes get flagged in the daily brief, ranked by amount. No more discovering them at month-end.

  • Multi-location aggregation

    Square supports multiple locations natively. Fynso aggregates across all of them for a unified cash and revenue view.

How to connect Square

  1. Step 1

    Open Fynso settings and choose Payments

    From the Fynso app, navigate to Settings → Connections → Payments → Add Square.

  2. Step 2

    Authorize through Square's OAuth flow

    Click Connect Square. You'll be redirected to Square's authorization page, where you sign in and approve the connection.

  3. Step 3

    Approve the read-focused scopes

    Fynso requests the standard read scopes: merchant profile, bank accounts, customers, items, orders, payments, payouts, settlements, invoices, subscriptions, and disputes. Square shows you the full list before you approve.

  4. Step 4

    Confirm the Square account

    If your Square login has multiple businesses, select the one Fynso should read. You can connect additional businesses to separate Fynso workspaces later.

  5. Step 5

    Initial sync runs automatically

    Fynso pulls Square's recent payment, payout, and order history. Typically completes in 1 to 3 minutes.

Security & privacy

Fynso connects to Square through Square's standard OAuth 2.0 flow. Fynso never stores your Square credentials. The requested scopes are read-focused: MERCHANT_PROFILE_READ, BANK_ACCOUNTS_READ, CUSTOMERS_READ, ITEMS_READ, ORDERS_READ, PAYMENTS_READ, DISPUTES_READ, INVOICES_READ, SUBSCRIPTIONS_READ, PAYOUTS_READ, SETTLEMENTS_READ, and EMPLOYEES_READ. Where the OAuth scope list also includes a few write permissions for completeness, Fynso's standard sync does not use them; any write activity would require explicit per-action approval. You can revoke the connection at any time from Square's Authorized Apps panel or from Fynso's connection settings.

TL;DR
  • Fynso connects to Square through standard OAuth 2.0. Setup takes about two minutes.
  • The standard sync requests read-focused scopes: merchant profile, bank accounts, customers, items, orders, payments, payouts, settlements, invoices, subscriptions, and disputes.
  • Square data feeds the daily cash forecast with real payout timing, surfaces processor fee drag, and flags failed payments and disputes in the brief.
  • Multi-location Square accounts aggregate natively. The brief gives you a unified view with optional per-location drill-down.
  • Revocable any time from Square’s Authorized Apps panel.

Why connect Square?

Because Square payouts move on a predictable schedule, and processor fees are a quiet line item that compounds.

Many service businesses, restaurants, and retail operations process the majority of revenue through Square. The data Square generates — payments, payouts, settlement timing, customer history, item-level revenue, dispute activity — is exactly what a daily cash forecast needs. Without the connection, that data sits in Square’s dashboard and shows up in Fynso only after it clears the bank (a few days late) and gets categorized in QuickBooks (a few days later still).

Connecting Square closes that gap. Payouts feed the forecast at their real arrival time. Fees get tracked against revenue, with drift flagged early. Disputes and failed payments appear in the daily brief the morning after they happen.

What does this integration unlock?

  • Payout and settlement-aware cash forecast. Square’s documented payout patterns (see Square’s Payouts API docs) feed the 30/60/90-day forecast directly.
  • Processor fee drag analysis. Fees tracked as a percentage of revenue, with specific charge types flagged when they’re eating more margin (keyed-in, premium cards, large transactions).
  • Order and revenue mix visibility. Square order data feeds margin and mix analysis — useful for multi-service or multi-location businesses watching which lines actually drive profit.
  • Customer concentration signals. Who’s coming back, who’s drifted, where revenue concentration is creating risk.
  • Failed payment and dispute surfacing. Catch issues the morning after they happen instead of at month-end.
  • Multi-location aggregation. Square’s native multi-location structure flows into Fynso as a unified view with optional drill-down.

How to connect Square

Five steps. About two minutes start to finish.

  1. Open Fynso settings → Connections → Payments → Add Square.
  2. Authorize through Square’s OAuth flow. Sign in to Square and approve the connection.
  3. Approve the read scopes. Square shows you the full scope list before approval: merchant profile, bank accounts, customers, items, orders, payments, payouts, settlements, invoices, subscriptions, disputes.
  4. Confirm the Square account. If your login has multiple businesses, select the one for Fynso to read.
  5. Initial sync runs. Fynso pulls recent payment, payout, and order history. Typically 1–3 minutes.

Security and privacy

The connection runs through Square’s standard OAuth 2.0 flow:

  • Fynso never stores your Square credentials. OAuth means Square handles authentication; Fynso receives a revocable access token.
  • The standard sync uses read-focused scopes. Specifically: MERCHANT_PROFILE_READ, BANK_ACCOUNTS_READ, CUSTOMERS_READ, ITEMS_READ, ORDERS_READ, PAYMENTS_READ, DISPUTES_READ, INVOICES_READ, SUBSCRIPTIONS_READ, PAYOUTS_READ, SETTLEMENTS_READ, EMPLOYEES_READ. Fynso’s daily sync workflows read this data and do not write.
  • Revocable any time. You can disconnect from Square’s Authorized Apps panel or from Fynso’s connection settings.

What this integration does not do

  • It doesn’t replace Square. Square remains your point-of-sale and payment processor.
  • It doesn’t initiate payouts or refunds automatically. Any write action would require explicit per-action approval.
  • It doesn’t replace your accounting integration. Square data is most useful when paired with QuickBooks or Xero plus a bank connection.
  • It doesn’t natively drive Square Appointments workflows. Fynso’s main-site product is focused on the financial decision layer; appointment and booking optimization lives on the Fynso Revenue product for businesses where scheduling is central to revenue.

Related reading

Bring Square into your daily forecast. Start a 14-day free trial — connect Square in two minutes, see payout-aware forecasting and fee drag the next morning.

Frequently asked questions

What data does Fynso read from Square?
Merchant profile, bank accounts (linked to Square), customers, items, orders, payments, payouts, settlements, invoices, subscriptions, disputes, and employee records. The data feeds the cash forecast, processor fee analysis, customer concentration view, and revenue mix tracking.
Does Fynso modify my Square data?
Not as part of the standard sync. The read scopes (MERCHANT_PROFILE_READ, PAYMENTS_READ, PAYOUTS_READ, etc.) cover everything Fynso needs for the daily brief and forecast. Any write action would require explicit per-action owner approval.
How does Square data improve the cash forecast?
Square payouts and settlements have well-defined timing patterns documented in Square's developer docs. Fynso reads the payout schedule directly and projects incoming funds at their real arrival time rather than waiting for the bank to confirm. For businesses where Square is the primary payment processor, this dramatically improves forecast accuracy.
Does Square work for multi-location businesses?
Yes. Square supports multiple locations natively, and Fynso aggregates across them. The brief gives you a unified view, and you can drill into per-location revenue and margin if you have multiple locations on a single Square account.
What about Square Appointments and bookings?
Fynso's main-site product is focused on financial decision support — cash, AR, payouts, margin. Square's appointment and booking data is read-available but isn't the primary focus of the CFO workflows. For appointment-based revenue insights, talk to us about whether the Fynso Revenue product is a better fit.
Connect Square in Fynso

Sources