Register readers

1. On the Readers tab on the Terminal Readers page, click Register Reader.
2. Enter the pairing code on the reader and click Next.
3. Provide a name for the reader.
4. Assign to a location or create a new one.
5. Confirm the details and click Register.

After you find the serial number, you can register the reader through the registration flow in the Dashboard.

1. On the Terminal Readers page, click Register reader.
2. Enter the serial number and click Next. To register multiple devices at once, you can enter multiple serial numbers, separated by commas.
3. Optionally, choose a name for the reader.
4. If you already created a location, select the reader’s new location. Otherwise, create a location by clicking + Add new.
5. Click Register to finish registering your reader.

In the Dashboard, you can register readers by the order number in one of two ways:

• From the order itself
• Entering the order number during the registration flow

From the order

1. On the Hardware orders page, find an order with a status of either shipped or delivered. Click the overflow menu () at the end of the row, then click Register.
2. On the Register Readers page, select one or more readers from the hardware order to register, then click Register.
3. Optionally, choose a name for the reader. If you selected multiple readers, the name serves as a prefix and we name the readers sequentially (for example, for a given input of “Test reader”, we name the readers “Test reader 1”, “Test reader 2”, and so on).
4. If you already created a location, select the reader’s new Location. Otherwise, create a Location by clicking + Add new.
5. Click Register to finish registering your readers.

Registration flow

1. On the Terminal Readers page, click Register reader.
2. Enter the order number and click Next. If there are registerable readers in the order, continue by clicking Register.
3. On the Register Readers page, select one or more readers from the hardware order to register, then click Register.
4. Optionally, choose a name for the reader. If you selected multiple readers, the name serves as a prefix and we name the readers sequentially (for example, for a given input of “Test reader,” we name the readers “Test reader 1,” “Test reader 2,” and so on).
5. If you already created a location, select the reader’s new location. Otherwise, create a location by clicking + Add new.
6. Click Register to finish registering your readers.

Register mobile readers (Stripe Reader M2, BBPOS Chipper 2X BT, and BBPOS WisePad 3) to a location while connecting to the reader by specifying the locationId in your BluetoothConnectionConfiguration. If you prefer, you can register the reader to the last used location by passing in the reader.locationId from a discovered reader.

// Call `connectReader` with the selected reader and a connection config
// to register to a location as set by your app.
let connectionConfig: BluetoothConnectionConfiguration
do {
    connectionConfig = try BluetoothConnectionConfigurationBuilder(delegate: yourMobileReaderDelegate, locationId: 
"{{LOCATION_ID}}")
    .build()
} catch {
    // Handle the error building the connection configuration
    return
}
Terminal.shared.connectReader(selectedReader, connectionConfig: connectionConfig) { reader, error in
    if let reader = reader {
        print("Successfully connected to reader: \(reader)")
    } else if let error = error {
        print("connectReader failed: \(error)")
    }
}