Customize Screen Interactions for Non-Payment Workflows Beta release

Applies to: Terminal APITerminal API

Learn how to customize how buyers interact with the Square Terminal through screen workflows.

In addition to processing checkouts and refunds, the Terminal APITerminal API allows you to configure buyer-facing screen interactions for the Square Terminal and build non-payment-related workflows that collect buyer information. You can configure these custom screen workflows using Terminal actions.

• A Square Terminal must be paired with a POS application.
• Applications must have the following OAuth permissions:
  • PAYMENTS_READ for getting or searching for a Terminal action request.
  • PAYMENTS_WRITE for creating or canceling a Terminal action request.
• Ensure that the Square Terminal software is up to date. On the Square Terminal, choose Settings, choose General, choose About Terminal, and then check the software version. For more information, see Square Terminal FAQSquare Terminal FAQ.
• Your developer account must be enabled to subscribe to Terminal API action webhooksTerminal API action webhooks.

With the CreateTerminalActionCreateTerminalAction endpoint, you can send action requests that trigger the Square Terminal to display a screen. In the request, you can customize the screen text and how the buyer provides their information on the screen's input fields.

In a Terminal action request, you specify the action type in the request body for a given screen. The Terminal API provides the following Terminal action types:

• Confirmation screenConfirmation screen - Allows you to collect a buyer's confirmation decision to the terms displayed on the screen.
• Signature captureSignature capture - Allows you to capture a buyer's signature for their records.
• Data collectionData collection - Allows you to collect contact information from the buyer, such as a phone number and email address.
• Menu selectMenu select - Allows you to display a list of options for the buyer to select.
• QR code displayQR code display - Allows you to display a QR code for buyers to scan.

Choose a type of buyer screen engagement to set up for the Square Terminal:

• Capture buyer information - See Get a Buyer's ConfirmationGet a Buyer's Confirmation, Capture a Buyer's SignatureCapture a Buyer's Signature, and Collect a Buyer's Contact InformationCollect a Buyer's Contact Information.

• Display a selection of options - See Display Menu Select OptionsDisplay Menu Select Options.

• Allow a buyer's smartphone to collect information - See Display a QR CodeDisplay a QR Code.

You can also link multiple screens to display in sequence for a given screen workflow and dismiss actions. For more information, see Link and Dismiss Terminal ActionsLink and Dismiss Terminal Actions.