Connecting Barcode Scanner not recommended by Square

Hi, we are building an integration with Square Terminal that requires to scan QR codes on products that are as a collections.

We have tried with one of the recommended QR code readers + Square HUB and it works directly, however the price for this solution is. too high as we need one scanner for each Terminal and we have +50 terminals in each location.

We have bought some cheap QR code scanners and connected them through USB to the Terminal, the terminal seems to recognize it as a keyboard but not as a scanning device to pull products from the collection.

Is there a way we can make the “plain” devices work as a the recommendd devices by Square?

We can provide videos on DM showing the setup.

:wave: I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:

https://developer.squareup.com/docs/app-marketplace/requirements/terminal-api

Additional Documentation

Reader SDK Quickstart
Reader SDK
https://developer.squareup.com/docs/squarebridge/business-central/payments/collect-payments

If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.

The Square Terminal API currently does not support direct integration with QR code scanners. The Terminal API is primarily designed to manage checkout and refund requests sent to a paired Square Terminal. However, you can use the Terminal API in conjunction with other Square APIs to build a more comprehensive solution.

For QR code scanning, the recommended devices are ones that Square has tested and confirmed to work with their hardware. Other devices might work, but Square cannot guarantee their compatibility or provide support for them.

If the cheaper QR code scanners are recognized as keyboards, it’s possible they are not compatible with the Square Terminal’s expected input methods. Unfortunately, there’s no way to modify the Terminal API to recognize these devices as scanners.

You may need to consider using the recommended devices or exploring other ways to integrate QR code scanning into your workflow.

This answer was reviewed by @Bryan-Square.

Hi Thanks for answering, what do you mean by other ways to integrate QR code scanning into our workflow? Can you be more specific? We don’t need to use the Terminal API as far as I understand, the scanner will be scanning products that are part of the catalogue in the Terminal device

Other creative QR code scanning could involve the customer scanning the QR code. Or whatever needs fits your use case.

To be honest they could scan codes to build an order on there own devices then your backend sends the checkout to a Terminal device for checkout. :slightly_smiling_face:

Hi Bryan, thanks for your answer, the solution you say is possible but the main objective of this integration is to not bother the client at any point as the point of sale is really busy and needs to be very fast, so we want everything handled by the person selling the product. That’s why we pre-load all the QR codes as collection on the Terminal and we want the person taking orders to just have to scan the products QR code and not have to do much more than get the client to pay and serving the product. Any other idea?

If that’s the case then it sounds like you will need the supported bar code scanner to scan all the codes. :slightly_smiling_face: