# \#terminal-api **URL:** https://developer.squareup.com/forums/tag/terminal-api/3.md [Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md) --- ## [Terminal Canada](https://developer.squareup.com/forums/t/terminal-canada/28237)
**Author:** [@OutdoorConsignment](https://developer.squareup.com/forums/u/OutdoorConsignment)\ **Replies:** 0\ **Last updated:** [October 16, 2026, 5:02am UTC](https://developer.squareup.com/forums/t/terminal-canada/28237 "2026-10-16T05:02:02Z")
I would like my customers in Canada to use square inside my application. Currently I only support US clients for Square ingration. I think it was the APP fee, doesn’t work if I have a us square account and they have a ca… --- ## [Testing Terminal checkout at multiple Sandbox locations](https://developer.squareup.com/forums/t/testing-terminal-checkout-at-multiple-sandbox-locations/28193)
**Author:** [@Aviro](https://developer.squareup.com/forums/u/Aviro)\ **Replies:** 2\ **Last updated:** [October 15, 2026, 4:25pm UTC](https://developer.squareup.com/forums/t/testing-terminal-checkout-at-multiple-sandbox-locations/28193 "2026-10-15T16:25:08Z")
Hi, I’m testing Terminal checkout with multiple locations under the same Sandbox account. It works at the original location, but at another location it just stays waiting for payment. We also tested this directly throug… --- ## [App\_fee\_money with Terminal API for Japan (JP) sellers in 2026](https://developer.squareup.com/forums/t/app-fee-money-with-terminal-api-for-japan-jp-sellers-in-2026/28073)
**Author:** [@keisuke](https://developer.squareup.com/forums/u/keisuke)\ **Replies:** 8\ **Last updated:** [October 15, 2026, 4:16pm UTC](https://developer.squareup.com/forums/t/app-fee-money-with-terminal-api-for-japan-jp-sellers-in-2026/28073 "2026-10-15T16:16:11Z")
Is app\_fee\_money supported with the Terminal API (CreateTerminalCheckout) for sellers located in Japan (JP)? A forum reply from 2024-07 stated that collecting app\_fee\_money with the Terminal API was not supported outs… --- ## [Terminal API: EBT/SNAP and debit cash back for a custom grocery POS?](https://developer.squareup.com/forums/t/terminal-api-ebt-snap-and-debit-cash-back-for-a-custom-grocery-pos/28113)
**Author:** [@Growthlinellc](https://developer.squareup.com/forums/u/Growthlinellc)\ **Replies:** 2\ **Last updated:** [October 9, 2026, 6:29pm UTC](https://developer.squareup.com/forums/t/terminal-api-ebt-snap-and-debit-cash-back-for-a-custom-grocery-pos/28113 "2026-10-09T18:29:06Z")
We are a US natural-foods grocer (USDA FNS-authorized, EBT/SNAP already active on our Square account) running a custom POS that drives Square Terminal through the Terminal API. Can Terminal API checkouts accept EBT SNA… --- ## [Valid production device code is refused by Terminal: "Incorrect device code"](https://developer.squareup.com/forums/t/valid-production-device-code-is-refused-by-terminal-incorrect-device-code/28125)
**Author:** [@DHNOW](https://developer.squareup.com/forums/u/DHNOW)\ **Replies:** 10\ **Last updated:** [October 8, 2026, 5:55pm UTC](https://developer.squareup.com/forums/t/valid-production-device-code-is-refused-by-terminal-incorrect-device-code/28125 "2026-10-08T17:55:23Z")
Update with more details, in case it helps. The device code is created correctly, but the Terminal refuses to accept it. What I did: Created the code with CreateDeviceCode in PRODUCTION (not Sandbox), using my produc… --- ## [Feature request: tip screen BEFORE payment for Terminal API checkouts](https://developer.squareup.com/forums/t/feature-request-tip-screen-before-payment-for-terminal-api-checkouts/28139)
**Author:** [@djmannyd](https://developer.squareup.com/forums/u/djmannyd)\ **Replies:** 2\ **Last updated:** [October 7, 2026, 11:55pm UTC](https://developer.squareup.com/forums/t/feature-request-tip-screen-before-payment-for-terminal-api-checkouts/28139 "2026-10-07T23:55:42Z")
Square’s own devices now ask for tips before payment (“Ask for Tips Before Payment”, announced May 2026), but Terminal API checkouts still show “Tap, Insert or Swipe” first and the tip screen after the card, even on Term… --- ## [Auto Card Surcharge not applied on Connected Terminal (allow\_auto\_card\_surcharge: true)](https://developer.squareup.com/forums/t/auto-card-surcharge-not-applied-on-connected-terminal-allow-auto-card-surcharge-true/28112)
**Author:** [@djmannyd](https://developer.squareup.com/forums/u/djmannyd)\ **Replies:** 4\ **Last updated:** [October 7, 2026, 6:39pm UTC](https://developer.squareup.com/forums/t/auto-card-surcharge-not-applied-on-connected-terminal-allow-auto-card-surcharge-true/28112 "2026-10-07T18:39:51Z")
We use the Terminal API (Connected Terminal) and completed Credit Card Surcharge onboarding in the Dashboard (3%, location M3529FJDGB5VE). Our CreateTerminalCheckout request sends device\_options.allow\_auto\_card\_surcharge… --- ## [Sandbox Interac payment missing refund\_requires\_card\_presence](https://developer.squareup.com/forums/t/sandbox-interac-payment-missing-refund-requires-card-presence/27967)
**Author:** [@Aviro](https://developer.squareup.com/forums/u/Aviro)\ **Replies:** 7\ **Last updated:** [October 4, 2026, 6:16pm UTC](https://developer.squareup.com/forums/t/sandbox-interac-payment-missing-refund-requires-card-presence/27967 "2026-10-04T18:16:21Z")
Hi Square team, I’m testing Interac refunds with the Terminal API in Sandbox. I completed a CAD checkout using the documented Interac test device. GetPayment shows a completed CARD payment with card\_brand INTERAC and en… --- ## [Terminal API device code sign-in always fails on Square Terminal in Japan (production)](https://developer.squareup.com/forums/t/terminal-api-device-code-sign-in-always-fails-on-square-terminal-in-japan-production/28016)
**Author:** [@kanehiko\_pos](https://developer.squareup.com/forums/u/kanehiko_pos)\ **Replies:** 9\ **Last updated:** [October 2, 2026, 3:45am UTC](https://developer.squareup.com/forums/t/terminal-api-device-code-sign-in-always-fails-on-square-terminal-in-japan-production/28016 "2026-10-02T03:45:05Z")
Hello, I am a seller in Japan building my own POS app that uses the Terminal API. I cannot pair my Square Terminal using a device code, and I would like help. What I did: Created a device code with CreateDeviceCode … --- ## [Delayed CANCELED terminal.checkout.updated Webhook](https://developer.squareup.com/forums/t/delayed-canceled-terminal-checkout-updated-webhook/27910)
**Author:** [@jiwonkim89](https://developer.squareup.com/forums/u/jiwonkim89)\ **Replies:** 7\ **Last updated:** [September 30, 2026, 2:55pm UTC](https://developer.squareup.com/forums/t/delayed-canceled-terminal-checkout-updated-webhook/27910 "2026-09-30T14:55:51Z")
Hello, We encountered an issue where a Terminal Checkout cancellation did not receive a webhook confirming the final CANCELED status until roughly 11 hours after the cancellation was requested. Here is the timeline of … --- ## [Terminal API auto card surcharge (Beta) never applies — enrollment path for Connected Terminal?](https://developer.squareup.com/forums/t/terminal-api-auto-card-surcharge-beta-never-applies-enrollment-path-for-connected-terminal/26787)
**Author:** [@anwar](https://developer.squareup.com/forums/u/anwar)\ **Replies:** 4\ **Last updated:** [August 11, 2026, 8:41pm UTC](https://developer.squareup.com/forums/t/terminal-api-auto-card-surcharge-beta-never-applies-enrollment-path-for-connected-terminal/26787 "2026-08-11T20:41:20Z")
Hi, We build a point-of-sale app for service businesses that drives Square Terminals via the Terminal API. Our sellers have completed credit card surcharge onboarding in the Square Dashboard (Beta, 3%). The Terminal di… --- ## [Unpaid dine-in QR orders not showing on Square Restaurant POS](https://developer.squareup.com/forums/t/unpaid-dine-in-qr-orders-not-showing-on-square-restaurant-pos/27148)
**Author:** [@Gobeeshan](https://developer.squareup.com/forums/u/Gobeeshan)\ **Replies:** 1\ **Last updated:** [August 11, 2026, 6:25pm UTC](https://developer.squareup.com/forums/t/unpaid-dine-in-qr-orders-not-showing-on-square-restaurant-pos/27148 "2026-08-11T18:25:46Z")
Hi, We’re building a dine-in QR ordering app where guests order from our customer app, and restaurant staff use Square for Restaurants POS. What we want: Guest places an unpaid order in our app Staff can see that ord… --- ## [Request for Instructions on Initiating QR Code Payments](https://developer.squareup.com/forums/t/request-for-instructions-on-initiating-qr-code-payments/27085)
**Author:** [@satoshi](https://developer.squareup.com/forums/u/satoshi)\ **Replies:** 2\ **Last updated:** [August 4, 2026, 3:46am UTC](https://developer.squareup.com/forums/t/request-for-instructions-on-initiating-qr-code-payments/27085 "2026-08-04T03:46:31Z")
I would like to ask for guidance on how to initiate QR code payments on a Square Terminal running the new firmware version 5.67.0101. After updating the Square Terminal firmware on July 29, 2026, I am no longer able to … --- ## [Is there an equivalent supported mechanism for Square Register and Square Handheld?](https://developer.squareup.com/forums/t/is-there-an-equivalent-supported-mechanism-for-square-register-and-square-handheld/27028)
**Author:** [@Dev-Internetsoft](https://developer.squareup.com/forums/u/Dev-Internetsoft)\ **Replies:** 7\ **Last updated:** [August 3, 2026, 9:46am UTC](https://developer.squareup.com/forums/t/is-there-an-equivalent-supported-mechanism-for-square-register-and-square-handheld/27028 "2026-08-03T09:46:56Z")
Is there any way to pair or link a specific Register/Handheld unit to our external Android app — similar to the Devices API’s device\_id for Terminal — so we can target a specific physical device (relevant for multi-regi… --- ## [Toggling visibility of 'All payment types' button on terminal checkout screen](https://developer.squareup.com/forums/t/toggling-visibility-of-all-payment-types-button-on-terminal-checkout-screen/26845)
**Author:** [@zmcnulty](https://developer.squareup.com/forums/u/zmcnulty)\ **Replies:** 5\ **Last updated:** [July 27, 2026, 10:18pm UTC](https://developer.squareup.com/forums/t/toggling-visibility-of-all-payment-types-button-on-terminal-checkout-screen/26845 "2026-07-27T22:18:14Z")
One of our customers recently reported the use of the ‘All payment types’ button at the top of the terminal checkout screen to bypass payment. Is it possible to limit access to this screen or simply toggle the individual… --- ## [Can we integrate our web application with Square Terminal for a self-service digital signage?](https://developer.squareup.com/forums/t/can-we-integrate-our-web-application-with-square-terminal-for-a-self-service-digital-signage/26844)
**Author:** [@Levias](https://developer.squareup.com/forums/u/Levias)\ **Replies:** 1\ **Last updated:** [July 17, 2026, 8:27pm UTC](https://developer.squareup.com/forums/t/can-we-integrate-our-web-application-with-square-terminal-for-a-self-service-digital-signage/26844 "2026-07-17T20:27:17Z")
Hello Square Developer Team, We are planning to integrate our web application with Square Terminal and would like to confirm whether the following architecture is supported. Our service is PRIZE3.0 Games https://www.pr… --- ## [Can a Square Terminal integration be reused with the Square Contactless + Chip Reader?](https://developer.squareup.com/forums/t/can-a-square-terminal-integration-be-reused-with-the-square-contactless-chip-reader/26838)
**Author:** [@Chris\_Ascenditure](https://developer.squareup.com/forums/u/Chris_Ascenditure)\ **Replies:** 1\ **Last updated:** [July 14, 2026, 11:12am UTC](https://developer.squareup.com/forums/t/can-a-square-terminal-integration-be-reused-with-the-square-contactless-chip-reader/26838 "2026-07-14T11:12:39Z")
Hello Square Developer Team, We’re currently integrating Square into our client’s platform (City Keys Live) using the Square Terminal API. We initially purchased and shipped a Square Terminal to our development team so… --- ## ["Merchant not authorized" error](https://developer.squareup.com/forums/t/merchant-not-authorized-error/26834)
**Author:** [@leaf1](https://developer.squareup.com/forums/u/leaf1)\ **Replies:** 2\ **Last updated:** [July 13, 2026, 4:46pm UTC](https://developer.squareup.com/forums/t/merchant-not-authorized-error/26834 "2026-07-13T16:46:06Z")
I’m building a custom POS application using the Square Terminal API (not a website checkout — this is a staff-facing point-of-sale system). My application needs production Terminal API approval. My Application ID is sq0i… --- ## [Terminal API Device Code Auth Error](https://developer.squareup.com/forums/t/terminal-api-device-code-auth-error/26666)
**Author:** [@ElectricCroc](https://developer.squareup.com/forums/u/ElectricCroc)\ **Replies:** 3\ **Last updated:** [July 3, 2026, 3:29pm UTC](https://developer.squareup.com/forums/t/terminal-api-device-code-auth-error/26666 "2026-07-03T15:29:44Z")
Hi, im having some trouble with the device code generation when following the terminal api youtube video from the sqaure space dev: sandbox 101: getting started with terminal api. The code is giving an error that says \< … --- ## [Terminal API checkout always returns NOT\_FOUND](https://developer.squareup.com/forums/t/terminal-api-checkout-always-returns-not-found/26611)
**Author:** [@satoshi](https://developer.squareup.com/forums/u/satoshi)\ **Replies:** 3\ **Last updated:** [July 2, 2026, 9:20pm UTC](https://developer.squareup.com/forums/t/terminal-api-checkout-always-returns-not-found/26611 "2026-07-02T21:20:15Z")
I’m using Square Terminal with the Terminal API. The device logs in correctly with a 6‑digit device code and shows AVAILABLE in the Devices API. However, every CreateTerminalCheckout request returns NOT\_FOUND and nothi… --- ## [TerminalCheckout Not Displaying Correct Screen](https://developer.squareup.com/forums/t/terminalcheckout-not-displaying-correct-screen/26324)
**Author:** [@jiwonkim89](https://developer.squareup.com/forums/u/jiwonkim89)\ **Replies:** 4\ **Last updated:** [June 9, 2026, 9:37pm UTC](https://developer.squareup.com/forums/t/terminalcheckout-not-displaying-correct-screen/26324 "2026-06-09T21:37:51Z")
We use the Square terminal for our self service kiosk. One merchant is experiencing an issue when a TerminalCheckout request is made, the terminal screen does not go to the blue Tap, insert, swipe page. Instead, it is sh… --- ## [Square terminal payment using terminal device and flutter app with backend](https://developer.squareup.com/forums/t/square-terminal-payment-using-terminal-device-and-flutter-app-with-backend/26124)
**Author:** [@Junayed](https://developer.squareup.com/forums/u/Junayed)\ **Replies:** 2\ **Last updated:** [June 5, 2026, 8:59am UTC](https://developer.squareup.com/forums/t/square-terminal-payment-using-terminal-device-and-flutter-app-with-backend/26124 "2026-06-05T08:59:44Z")
I want to add terminal payment of square . Now i want to know that if i add terminal apis that creates terminal checkout i have tested from sandbox it shows pending after while it got cancelled with timeout reason . I fo… --- ## [Display on a Square Terminal in Paired mode doesn't sleep](https://developer.squareup.com/forums/t/display-on-a-square-terminal-in-paired-mode-doesnt-sleep/600)
**Author:** [@jamesrclay](https://developer.squareup.com/forums/u/jamesrclay)\ **Replies:** 23\ **Last updated:** [May 26, 2026, 12:12am UTC](https://developer.squareup.com/forums/t/display-on-a-square-terminal-in-paired-mode-doesnt-sleep/600 "2026-05-26T00:12:16Z")
With a Square Terminal in Paired mode, the “Ready to take a payment” screen never sleeps, despite the Display settings set to Turn Off Display after 1 Minute. I can’t imagine this is by design as it means the display is… --- ## [Feasibility Question re: 1099s as Resellers for Event Ticketing Platform](https://developer.squareup.com/forums/t/feasibility-question-re-1099s-as-resellers-for-event-ticketing-platform/26030)
**Author:** [@Chris\_Ascenditure](https://developer.squareup.com/forums/u/Chris_Ascenditure)\ **Replies:** 4\ **Last updated:** [May 20, 2026, 3:40pm UTC](https://developer.squareup.com/forums/t/feasibility-question-re-1099s-as-resellers-for-event-ticketing-platform/26030 "2026-05-20T15:40:03Z")
Hi Everyone, We have created ticketing platform for a client (think TicketMaster) in the NYC area, and we have developed a setup in which third-party partner organizations — most commonly hotels — can sell tickets throu… --- ## [Square Terminal API vs Square Register](https://developer.squareup.com/forums/t/square-terminal-api-vs-square-register/25966)
**Author:** [@deltaDev](https://developer.squareup.com/forums/u/deltaDev)\ **Replies:** 1\ **Last updated:** [May 1, 2026, 4:42pm UTC](https://developer.squareup.com/forums/t/square-terminal-api-vs-square-register/25966 "2026-05-01T16:42:54Z")
I am working on an app that integrates with the Terminal API, it works great with Square Terminals (obviously). I wanted to know if there was a way that anyone knew if it was possible to pair a square register with a pai… --- ## [NFC loyalty tap (Apple VAS / Google Smart Tap)](https://developer.squareup.com/forums/t/nfc-loyalty-tap-apple-vas-google-smart-tap/25512)
**Author:** [@ara](https://developer.squareup.com/forums/u/ara)\ **Replies:** 1\ **Last updated:** [March 23, 2026, 9:49am UTC](https://developer.squareup.com/forums/t/nfc-loyalty-tap-apple-vas-google-smart-tap/25512 "2026-03-23T09:49:58Z")
Do Square terminals/POS support loyalty identification via Apple VAS and/or Google Smart Tap? If yes, can the tap event / identifier be exposed to partners (API/webhook) for matching and attribution? Is “enroll/add a Wa… --- ## [Dynamic QR code for Receipts](https://developer.squareup.com/forums/t/dynamic-qr-code-for-receipts/25636)
**Author:** [@jcrone](https://developer.squareup.com/forums/u/jcrone)\ **Replies:** 0\ **Last updated:** [March 23, 2026, 5:54am UTC](https://developer.squareup.com/forums/t/dynamic-qr-code-for-receipts/25636 "2026-03-23T05:54:30Z")
We do custom QR codes for feedback. My customers run their POS and on our system receipts the retailers can have feedback QR codes for their customers. Would be nice to have it for orders or the terminal api. The ability… --- ## [Test Account Dashboard Shows 0.00](https://developer.squareup.com/forums/t/test-account-dashboard-shows-0-00/25619)
**Author:** [@jcrone](https://developer.squareup.com/forums/u/jcrone)\ **Replies:** 0\ **Last updated:** [March 20, 2026, 3:26pm UTC](https://developer.squareup.com/forums/t/test-account-dashboard-shows-0-00/25619 "2026-03-20T15:26:56Z")
I have made a lot of changes to my codebase the last few weeks. I have been testing the Terminal API. I noticed that my dashboard is blank in the Test Account. If I go to Transactions I see them there but the dashboard i… --- ## [Urgent Update: Square Terminal failure (Stuck in LOGO screen)](https://developer.squareup.com/forums/t/urgent-update-square-terminal-failure-stuck-in-logo-screen/25328)
**Author:** [@wsdzy2010](https://developer.squareup.com/forums/u/wsdzy2010)\ **Replies:** 7\ **Last updated:** [February 11, 2026, 1:02am UTC](https://developer.squareup.com/forums/t/urgent-update-square-terminal-failure-stuck-in-logo-screen/25328 "2026-02-11T01:02:14Z")
Hi Square Support, We need to escalate this ticket immediately. This issue is causing a critical blockage for the merchant. Approximately 90% of their sales are processed through these kiosks, and they are currently una… --- ## [Terminal API cannot show signature page](https://developer.squareup.com/forums/t/terminal-api-cannot-show-signature-page/11684)
**Author:** [@nnfolove](https://developer.squareup.com/forums/u/nnfolove)\ **Replies:** 3\ **Last updated:** [February 6, 2026, 7:12pm UTC](https://developer.squareup.com/forums/t/terminal-api-cannot-show-signature-page/11684 "2026-02-06T19:12:24Z")
Hi, I use terminal api create terminal checkout with /v2/terminals/checkouts. I set collect\_signature is true. but signature page not show. The payload data is: { "idempotency\_key": "aa2e7c88-c43a-4bcd-affd-13d74f8… [Next page](https://developer.squareup.com/forums/tag/terminal-api/3.md?match_all_tags=true&page=1&tags%5B%5D=terminal-api)