How POS Terminal Management Works

Source: pos_terminals_controller.rb

• Terminal type is determined by the combination of integration type and country; Assembly Payments terminals are restricted to Australia-only
• Assembly POS terminal IDs accept alphanumeric characters only; serial numbers accept alphanumeric characters plus hyphens
• Adding a TNP terminal automatically enables multi-terminal mode on the company; this is a permanent, one-way toggle that cannot be reversed through the UI
• Deleting a terminal clears it as the default terminal for all users who had it set as their default
• Clearing Assembly terminal pairing keys forces the terminal to go through the re-pairing process

Support scenarios

• "We added a TNP terminal and now we can't go back to single-terminal mode" → Adding a TNP terminal permanently enables multi-terminal mode. This is a one-way toggle by design and cannot be reversed through settings.
• "After deleting a terminal, users are getting errors when trying to process payments" → Deleting a terminal clears it as the default for all users. Each affected user needs to select a new default terminal in their settings.
• "Assembly terminal won't connect after we cleared the keys" → Clearing pairing keys forces a full re-pair. The terminal needs to go through the physical pairing process again with the new keys.
• "We're trying to add an Assembly terminal but we're not in Australia" → Assembly Payments terminals are restricted to Australian companies only. Non-Australian companies need to use a different terminal integration.