Device compatibility for /v2/terminals/checkouts

Apologies if this has been answered somewhere.

Does the /v2/terminals/checkouts Create Terminal Checkout support a device that is a cellphone with this POS application installed and enabled? If not, is there a list of what type of devices are supported with this API call?

Currently I have my cellphone running, logged in with the paired code, but when trying to create terminal checkout, it is failing with:
Error creating terminal checkout: [{‘code’: ‘BAD_REQUEST’, ‘detail’: ‘Merchant not authorized for device_id=my_actual_id’, ‘category’: ‘INVALID_REQUEST_ERROR’}]

Thank you!

: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

Build on Mobile Web
Square Developer Documentation
Use the Point of Sale API in Offline Mode

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.

Hmm. From that reading, it sounds like:

1.) A point of sale app on a phone, is not a terminal.

2.) Terminal is the physical card device

3.) Sending payments to a phone for checkout requires using the Point of Sale API, and the Terminal API s for sending to the physical terminals.

Which now that I type out, seems pretty straight forward. If someones able to confirm my thought process on this, that would be super helpful. Thank you!

Yes, you can connect a Terminal to the POS in the settings of the app. When you click Settings > Hardware you’ll be given the option to connect with a Terminal. :slight_smile: