Issues with new handheld device and terminal API

Questions
1

Hi there,

We currently have a process of adding terminal devices via our UI using the terminal API. We first generate a device code using “TERMINAL_API”, and then use the code on the terminal devices and use the list devices endpoint to query the devices for that account.

This works fine for the existing terminal devices, but the new handheld ones don’t seem to work.

They take the code, and the UI on the device changes so that it seems like it’s connected, but we don’t get any devices back from from the list devices endpoint.

Is this a restriction or maybe an issue with our API version?

We are using API version 2025-02-20

Hopefully you can shed some light.

Kind regards,

Sam

2

:waving_hand: 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:

Additional Documentation

Develop for Japan
Develop for Japan
Square Sandbox

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.

3

The team was able to replicate this and working on a fix. :slight_smile:

4

Ah great thank you.

Do you know roughly when we can expect to see this fix be released? got a few people waiting at this moment.

Kind regards,

Sam

5

At this time I don’t have a timeline however it is a priority. :slight_smile:

6

Hello,

Is this still an issue? Can we use the terminal API now to send checkout info to one of the new Square Handheld devices?

We are trying to decide which device to purchase, and being able to send checkout info to integrate with our separate event ticketing system is critical.

If the terminal API doesn’t work with the new handheld device, we’ll just have to go with the terminal.

Thanks!

7

Yes, you can definitely use the new handheld with Terminal API. :slight_smile:

8

Hi sorry yes they fixed it within a few days of this post, the handhelds definitely work with the terminal API.