Menu
Feedback
Start here

Known issues

Known issues
Terminal Connector loops instead of showing error when invalid terminal code is entered (Sales App POS)
Payments
ID: 1303282
Backlog
Published on10/7/2025
Last updated on10/7/2025
1 min read

Summary

When a user inputs a non-existent terminal serialNumber/code, the terminal-connector flow should show an error, but the native app vtex.terminal-connector-app enters an infinite loop, and the screen remains stuck on “Waiting for payment on the terminal. Affects Sales App POS flows using vtex.terminal-connector-app when an invalid terminal code is provided

Simulation

  • Start a payment on salesApp that opens vtex.terminal-connector-app to collect the terminal serialNumber.
  • Enter a non-existent/invalid terminal code.
  • Observe that checkout’s continue to return to the app, and the screen remains in a loop instead of closing and returning to checkouts page.

Workaround

Close the terminal challenge screen using the top X and restart the payment flow.

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX Community
Join our community
Request VTEX support
For personalized assistance, contact our experts
Open a support ticket
GitHubDeveloper PortalCommunityFeedback