Integration guide

What connecting WaveWage actually touches

Connecting WaveWage is a read-mostly integration you finish in one sitting. Here’s exactly what we touch, written for the person who has to approve it.

  • Read-mostly
  • At most one write: the bonus
  • Encrypted at rest
  • Revocable anytime

Square

Self-serve OAuth
How you connect
An owner or admin clicks Authorize in Square and grants the scopes below, and that’s it. There are no API keys for your team to mint, rotate, or store. Takes about a minute.
  • MERCHANT_PROFILE_READidentify the business & its locations
  • EMPLOYEES_READsync the roster
  • TIMECARDS_READread hours worked
  • TIMECARDS_WRITEwrite the end-of-day bonus into the day's pay rate
  • ORDERS_READread sales
  • ITEMS_READcategory tags on sales
What we read
Your roster, timecards / attendance, and orders (sales, with category tags). Nothing else.
What we write
Only the end-of-day bonus, folded into the day’s timecard pay rate so Square Payroll pays it out as regular wages. That’s the one field Square both imports and pays. We never modify orders, prices, employee profiles, or anything else in your Square account.
Credentials & security
The OAuth token is envelope-encrypted at rest and scoped to your account. Revoke access anytime by removing the app in Square, with no call to us required.
Time to live
~1 minute. Most Square merchants are live the same session.
Still have questions?

Put your IT lead on the call.

We’ll walk through exactly what a connection touches for your setup and get you live on the fastest path.