Can we integrate our web application with Square Terminal for a self-service digital signage?

Hello Square Developer Team,

We are planning to integrate our web application with Square Terminal and would like to confirm whether the following architecture is supported.

Our service is PRIZE3.0 Games https://www.prize3games.com/, an online digital gacha game platform.

Our planned setup is as follows:

  • We install a large digital signage touchscreen at retail stores and event venues.
  • Our PRIZE3 web application runs in a web browser on the touchscreen.
  • A Square Terminal is physically attached next to the touchscreen.
  • When a customer selects a game and presses “Play”, our web application sends a payment request to the Square Terminal using the Terminal API.
  • The customer completes the payment by tapping or inserting their credit card on the Square Terminal.
  • Once the payment is approved, our web application continues the game flow.

Our questions are:

  1. Is this type of integration supported using the Square Terminal API?
  2. Can a browser-based web application communicate with a paired Square Terminal (through our backend) to initiate payments?
  3. Are there any limitations or recommended architecture for this type of self-service kiosk / digital signage implementation?

We are not trying to run our application on the Square Terminal itself. The Terminal would only be used to securely accept card payments, similar to how payment terminals are used with self-service ordering kiosks.

Any guidance or examples would be greatly appreciated.

Thank you!

Hey @Levias!

Strictly from an engineering perspective, there aren’t any issues with connecting Terminal API to a browser-based web application. Terminal API only requires that an HTTP request is sent to the CreateTerminalCheckout endpoint to initiate a transaction, so any stack that’s capable of doing that can be integrated with Terminal API. Using Terminal API with a web-app for a self-service kiosk is a very common use case.

Please note however that this should not be used for a fully unattended use case. An employee should be present at all times within view of the kiosk, and it should only be active during business hours.