PAYMENTS INTEGRATION
Square integration with the Unify Payments API
Read Square charges, refunds and payouts, plus 3 more objects, on one data model, in beta.
GET /v1/finance/charges?platform=square&limit=1
API design previewRequest
curl "https://api.unifyint.com/v1/finance/charges?platform=square&limit=1" \
-H "Authorization: Bearer $UNIFY_API_KEY"200 OK · API design preview
{
"data": [
{
"id": "cha_01EXAMPLE",
"object": "charge",
"remote_id": "example-1001",
"amount": 1250,
"currency": "USD",
"status": "settled",
"updated_at": "2026-10-28T14:02:11Z",
"raw": { "...": "original Square record, unchanged" }
}
],
"next_cursor": null
}GET /v1/finance/charges?platform=square&limit=1 (API design preview)
const res = await fetch("https://api.unifyint.com/v1/finance/charges?platform=square&limit=1", {
headers: { Authorization: `Bearer ${process.env.UNIFY_API_KEY}` },
});
const { data, next_cursor } = await res.json();API design preview. Field names may change before general availability.
About the Square integration
Square is a payments and point-of-sale platform for retailers, restaurants and service businesses. The Unify Payments API reads its payments, refunds, payouts, disputes, customers and orders.
Square's APIs use OAuth 2.0, offer a full sandbox and emit webhooks for payments, refunds, payouts and orders. The Unify Payments API maps payments, refunds, payouts with their entries, disputes, customers, locations and orders to the Unify Graph, so in-store and online sales reconcile the same way.
- Status
- Beta
- Category
- Payments, Commerce
- Auth
- OAuth 2.0
- Sandbox
- Available
- Webhooks
- Yes
- Bank feeds
- No
- Regions
- US, CA, UK, AU, JP
Supported objects
Read and write status for each Square object in the Unify Payments API. Write appears only where write-back is confirmed.
Charges
Read · BetaRefunds
Read · BetaWrite on roadmapPayouts
Read · BetaBalance Transactions
Read · BetaDisputes
Read · BetaCustomers
Read · BetaWrite on roadmap
Why build Square on Unify Int
One data model
Square records arrive in the same Unify Graph shape as every other platform in the category, with the original record kept in raw.
Unify Connect
A white-label flow for your customers to authorize Square. Tokens are stored and refreshed for you.
Custom fields and passthrough
Map Square custom fields per connection, and call any endpoint the model does not cover through passthrough requests.
Unify Monitor
Request logs, sync health and alerts for every Square connection, so support can see what happened.