You are viewing an old version of the API
Technical ReferenceSquare API
Square 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.
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.
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.
The Payments API lets developers take and manage payments
Manage and issue refunds for payments made to Square merchants
Use the Disputes API to manage disputes (chargebacks).
Accept itemized payments on a Square-hosted webpage, no frontend experience required
Apple Pay support APIs
Requests a checkout from a paired Square Terminal
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.
Create and manage subscriptions.
Subscriptions enable sellers to generate a reliable cash flow and recurring revenue to grow their businesses. Square offers the Subscriptions API for developers to embed subscription functionality in their applications. You first create a subscription plan using the Catalog API and then use the Subscriptions API to create and manage subscriptions.
For more information, see Square Subscriptions.
Create and manage invoices.
Square invoices enable you to request or automatically collect payments from customer for orders created using the Orders API.
The Invoices API makes it easy for you to manage invoices. After you create and publish an invoice using the API, Square follows up with customers: sends invoices to the customer's email address or automatically charges the customer's card on file. Square makes it easy for your customers to pay by hosting each invoice on a web page where customers can pay for it.
For more information, see Manage Invoices Using the Invoices API.
APIs for enriching payments with items and inventory
Sync merchant catalogs and inventory to provide consistent itemization and reporting across all channels
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.
Create and manage customer profiles, save cards on file for customers, and sync CRM systems with Square.
Programmatically create and manage customer groups to streamline and automate workflows, and to enable more personalized customer interactions.
List and retrieve customer segments (aka smart groups) in the business account.
Create loyalty accounts for buyers in a loyalty program, allow them to earn points, and to redeem rewards.
Create loyalty accounts for buyers in a loyalty program, add points to their loyalty account, and redeem rewards.
Manage locations and merchant details
Use the Location and Merchant APIs to keep track of core business details, such as addresses and business hours. Use Devices and Cash Drawers to keep track of the point of sale devices and cash drawer shift activity in a business.
Manage your team of employees
Use the Team and Labor APIs to keep track of who works at your business and when they clock in / out.
Get details about your business' deposits and bank accounts
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.
Other resources to help you build