Use the Point of Sale API in Offline Mode

Continue to process payments offline during moments of limited connection to the Internet.

The Point of Sale API supports payment processing with the Square Point of Sale application in Offline Mode.

Link to section

Accept offline payments

To accept offline payments with the Point of Sale API:

  1. In the Square Point of Sale application, choose Settings, and then choose Offline Mode.

  2. Toggle Allow Offline Mode to on, review the information, and then choose Allow Offline Mode.

    Important

    Offline payments are processed automatically when you reconnect your device to the Internet. Payments might be declined if not processed within 24 hours.

Link to section

Offline payment results

Offline payment results don't include a transaction_id field because Square backend systems haven't received and processed the transaction. Instead, the response includes a client_transaction_id field, which matches the value of client_id in Transaction objects. Use client_transaction_id to retrieve the transaction details using the Transactions API ListTransactions endpoint when Internet connection is restored and the Square Point of Sale application processes the staged transactions.

It's not currently possible to filter ListTransactions results by the client_id field.