Salesforce Docs Portal

Hardware Topology Setup

Point of Sale's Printer and Payment Terminal Topology allows you to determine whether the application is paired with a printer or payment terminal one-to-one (1:1) for an extended period of functionality or whether it's one-to-many (1:N) where it is prompted each time to select the device to use.

Configuring Printer Topology - 1:1

Select the printer you want to pair and print for an extended session at the merchant or register level in Point of Sale CMS.

Merchant Level

  1. Go to Store Management > Store Settings > Store register.
  2. Under Retrieve Current Printer Topology For Merchant, select "1:1". Select 1:1 for Printer Topology on the Store Register screen

Register Level

  1. Go to Store Management > Registers.
  2. Select a store from the dropdown.
  3. Edit a register.
  4. Go to Receipt Printer > Printer Topology and select "1:1". Set 1:1 for Printer Topology at the Register level

POS App Flow

The 1:1 topology lets you select the printer you want to pair and print for an extended session. If you don't have a printer initially, you'll still be prompted to select a printer at the beginning of the session. If printing a receipt or completing a cash transaction, this dedicated printer will be used. In the Device Manager screen, look for all the printers on the network that are available. For 1:1 pairing, you can select your printer from here.

1:1 Printer Topology setup in the POS app

Configuring Printer Topology - 1:N

Select a printer each time the POS app does any printer-related functionality at the merchant or register level in Point of Sale CMS.

Note
Note Note: 1:N configuration is not supported if connecting via Bluetooth.

Merchant Level

  1. Go to Store Management > Store Settings > Store register.
  2. Under Retrieve Current Printer Topology For Merchant, select "1:N". Set 1:N for Printer Topology at the Merchant Level

Register Level

  1. Go to Store Management > Registers.
  2. Select a store from the dropdown.
  3. Edit a register.
  4. Go to Receipt Printer > Printer Topology and select "1:N". Set 1:N for Printer Topology at the Register Level

POS App Flow

If printing a receipt or completing a cash transaction, you'll be presented with a list of printers that have been discovered on your network. Select your printer (denoted by a check mark) and tap Confirm. After you select a printer, it’s auto-selected on subsequent flows.

Note
Note Note: In a 1:N setup, devices can still see all printers on the floor, including printers connected in 1:1 modes.

View how 1:N mode functions in the POS app for Printer Topology

Configuring Payment Terminal Topology - 1:1

Select the payment terminal you want to pair and use it for an extended session. Configure the setup at the merchant or register level in Point of Sale CMS.

Merchant Level

  1. Go to Store Management > Store Settings > Store register.
  2. Under Retrieve Current Payment Topology For Merchant, select "1:1"Set 1:1 topology for Merchant Level

Register Level

  1. Go to Store Management > Registers.
  2. Select a store from the dropdown.
  3. Edit a register.
  4. Go to Receipt Printer > Payment Terminal Topology and select "1:1". Set 1:1 topology for Register level

POS App Flow

1:1 topology lets you select the payment terminal you want to pair and use for an extended session. If you don't have a payment terminal initially, you'll still select a device at the beginning of the session. If selecting pay by card, this dedicated payment terminal is used.

In the Device Manager screen, look for all the payment terminals on the network that are available. For 1:1 pairing, you can select your payment terminal from here.

1:1 Topology for Payment Terminals in POS App

Configuring Payment Terminal Topology - 1:N

Select a payment terminal each time the application does any payment terminal-related functionality at the merchant or register level in Point of Sale CMS.

Note
Note Note: 1:N configuration is not supported if connecting using Bluetooth and the POS app is in offline mode.

Merchant Level

  1. Go to Store Management > Store Settings > Store register.
  2. Under Retrieve Current Payment Topology For Merchant, select "1:N". Set 1:N topology for Payment Terminals at the Merchant Level

Register Level

  1. Go to Store Management > Registers.
  2. Select a store from the dropdown.
  3. Edit a register.
  4. Go to Receipt Printer > Payment Terminal Topology and select "1:N". Set 1:N topology for Payment Terminals at the Register Level
Note
Note Note: If the POS app switches to offline, the payment topology will behave as if it's set to 1:1. If it switches back to online, it restores the 1:N behavior. The selected payment terminal is only preserved in 1:1 topology.

POS App Flow

If an order is being paid with a card, you'll receive a list of terminals that have been discovered on your network. Select your terminal (denoted by a check mark) and tap Confirm. After you select a payment terminal, it'll be auto-selected on subsequent flows.The POS App flow for Payment Terminals using 1:N topology