Square

Square organizes business by Locations (stores). Locations have Orders, Payments, Inventory, and Team Members. Customers and Loyalty are merchant-wide.

Data Model

• Locations — physical or virtual stores; most data is location-scoped.
• Orders — transactions; can have line items and fulfillments.
• Payments — payment transactions.
• Refunds — refunds on payments.
• Customers — customer records.
• Inventory — stock levels per location.
• Team Members — staff; have shifts and wages.
• Shifts — work shifts.
• Cash Drawers — cash drawer state.
• Loyalty — loyalty programs and rewards.
• Bank Accounts — connected bank accounts.
• Taxes — tax configuration.

Gotchas

• location_id required: Most operations require a location. List locations first.
• Idempotency: Payment and order creation support idempotency keys; use for retries.