Hi, is there a way to display information on the terminal when issuing a checkout ? (like information on what was bought by the customer ?)
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
Verify the Payment
Take Payments on Square Hardware
Collecting Information
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.
Yes, you can display information on the terminal during a checkout by setting the TerminalCheckout note parameter to the partner name, setting an invoice/order number that is also visible on the partner platform, and setting the reference_id parameter to a unique human-readable reference number. This typically helps in reconciling payments across the partner and Square platforms. However, please note that the Terminal API doesn’t support itemized transactions. Transactions processed with the Terminal API appear on buyer receipts and in the Seller Dashboard with an optional note and the total transaction amount.
This answer was reviewed by @Bryan-Square.
Hi,
As far as I know, it’s true, that the Square Terminal API doesn’t support itemized information during a checkout, so individual items won’t be displayed. But you can include a summary or reference details by setting the note parameter in the Terminal API’s TerminalCheckout request. This could include a brief description, like Order #12345 or the main product category. The reference_id field can also be used for internal tracking, allowing for easy reconciliation in the Square Dashboard.
Hope it helps