Device code generated via API not accepted (requires 12 digits)

We are using the terminal API to generate a device code for terminal checkout (via the create device code endpoint).

One customer is having issues connecting because the API returns a 6 digit device code but they are saying their terminal device requires a 12 digit device code.

Is there something we need to do differently when calling the API to generate a 12 digit device code? Or is there something with their device that would make it require 12 digits? The client contacted Square support who said only 12 digit device codes could be used.

: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

Get Started
Get Started
Get Developer Credentials

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 Terminal API typically generates a 6-digit device code for pairing a Square Terminal. If the customer is being told by Square support that only a 12-digit device code can be used, it might be due to a specific requirement or configuration related to their device or account setup. However, based on the standard documentation, the API should generate a 6-digit code.

There is no standard configuration or API call that would change the device code length from 6 digits to 12 digits. It might be worth verifying with the customer if there is any specific context or additional information provided by Square support that could clarify why a 12-digit code is required. Additionally, ensure that the customer is using the correct process for entering the device code on their terminal. If the issue persists, further investigation with Square support might be necessary to resolve any account-specific or device-specific requirements.

This answer was reviewed by @Bryan-Square.

When entering the code it will prompt the customer for additional digits but the 6 digit format for the device code is correct with Terminal API and the device will accept the generated code. :slight_smile:

1 Like

Thank you!

After I shared this they were still reporting issues. It turned out the customer had an iPad with Square on it and not a Square Terminal device which is why it wasn’t working.