Technical Reference
You are viewing an old version of the API
Technical Reference
Technical Reference
Square APISquare APIs enable you to accept payments securely and integrate your app with Square’s first party product ecosystem. Build full-featured business apps for yourself or millions of Square sellers.
Our API Reference is organized around core business workflows: taking payments, managing orders, syncing items and inventory with Square Point of Sale, creating customer records, managing business locations, and enabling Square sellers to use your app.
The Square API follows the general patterns of REST. If you’re new here, you may want to check out our Getting Started Guide or learn more about the Square Data Model.
IMPORTANT: We recommend using the Square API (V2) for all new development when possible. See When to use Connect V1 to learn more about working with V1 endpoints.
Payments
Take payments and issue refunds
Square's Payment APIs make it easy for you to take payments, manage refunds, and help customers check out online.
-
Payments
The Payments API lets developers take and manage payments
-
Refunds
Manage and issue refunds for payments made to Square merchants
-
Disputes
Use the Disputes API to manage disputes (chargebacks).
-
Checkout
Accept itemized payments on a Square-hosted webpage, no frontend experience required
-
Apple Pay
Apple Pay support APIs
-
Terminal
Requests a checkout from a paired Square Terminal
Orders
Itemize payments, issue refunds, and push orders into Square of Sale
Square's Payment APIs make it easy for you to take itemize payments, fulfill orders at physical locations, and report on a merchant's sales.
Items
APIs for enriching payments with items and inventory
Sync merchant catalogs and inventory to provide consistent itemization and reporting across all channels
Customers
Create and manage customer profiles, save cards on file for customers, and sync custom CRM systems with Square.
Create and manage customer profiles, as well as search for customers based on various criteria such as customer group membership and when the customer was created. Save cards on file for the customers to facilitate future transactions. Sync contacts between your CRM system and Square.
-
Customers
Create and manage customer profiles, save cards on file for customers, and sync CRM systems with Square.
-
Customer Groups
Programmatically create and manage customer groups to streamline and automate workflows, and to enable more personalized customer interactions.
-
Customer Segments
List and retrieve customer segments (aka smart groups) in the business account.
Business
Manage locations and merchant details
Use the Location and Merchant APIs to keep track of core business details, such as addresses and business hours
Team
Manage your team of employees
Use the Employee and Labor APIs to keep track of who works at your business and when they clock in / out.
Financials
Get details about your business' deposits and bank accounts
Auth
Manage access to Square merchant accounts
Use OAuth to gain programmatic access to other Square merchants, and use the Mobile Authorization API to grant access to Reader SDK to take payments.
Additional Resources
Other resources to help you build