Point of Sale API

What It Does

The Point of Sale API lets mobile applications open the Square Point of Sale application to process in-person payments using Square hardware. Developers can use the Point of Sale API to build customized point-of-sale solutions or any other application that requires payments without worrying about hardware integrations. Square takes on the burden of staying PCI compliant. No checklists, assessments, or audits are required. The Point of Sale API is available for native and web applications running on iOS and Android.

Requirements and limitations Permalink Get a link to this section

The Point of Sale API requires an Android or iOS device with the most recent version of the Square Point of Sale application installed.

The Point of Sale API does not support:

Processing card payments with the Point of Sale API requires:

  • An activated Square seller account for accepting card payments.

  • A Square Reader for accepting card payments.

Processing fees for transactions initiated with the Point of Sale API are identical to fees for transactions initiated directly from the Square Point of Sale application. For more information, see Learn About Square's Fees.

Product components Permalink Get a link to this section

A complete mobile POS solution is comprised of a mobile device, a Square card reader, mobile device logic, and a backend service that uses the Catalog API to get items and services for purchase.

Mobile frontend Permalink Get a link to this section

A mobile application uses the Point of Sale API to create a charge request, start a transaction, open the POS UI, and parse transaction results. The Point of Sale API takes care of transmitting a payment to Square for crediting to a Square account.

A charge request includes a payment total amount that can be arbitrary or derived from the unit price of a catalog item or service.

Mobile backend Permalink Get a link to this section

A mobile application should have a backend process to connect to the product catalog defined for the Square account. The backend provides catalog items and services to the mobile device so that the device can show descriptions and unit prices.

A mobile backend is not required if the mobile application does not display the product catalog in a Square account.

Get started Permalink Get a link to this section

Use the following build guides to integrate with the Point of Sale API: