Register readers
Register your readers to a location.
You must register your reader to a location to accept payments. The process for registering your reader to a location differs based on whether it’s a smart reader or a Bluetooth reader.
Smart readers ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Registration code![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
For this method, you must generate a pairing code (also known as a registration code) on the reader. If a reader isn’t registered, a pairing code automatically appears on the screen when you unbox it. If it isn’t, or if you need to re-register a reader, you can generate a new pairing code using the admin settings. After generating the pairing code, you can enter it in the Dashboard or API to register the reader.
- On the Readers tab on the Terminal Readers page, click Register Reader.
- Enter the pairing code on the reader and click Next.
- Provide a name for the reader.
- Assign to a location or create a new one.
- Confirm the details and click Register.
Bluetooth readers ![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Register Bluetooth 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.
let connectionConfig: BluetoothConnectionConfiguration
do {
connectionConfig = try BluetoothConnectionConfigurationBuilder(locationId: ).build()
} catch {
return
}
Terminal.shared.connectBluetoothReader(selectedReader, delegate: readerDelegate, connectionConfig: connectionConfig) { reader, error in
if let reader = reader {
print("Successfully connected to reader: \(reader)")
} else if let error = error {
print("connectBluetoothReader failed: \(error)")
}
}
Note
Terminal SDK versions earlier than v2.0.0 don’t support registering BBPOS Chipper 2X BT or WisePad 3 readers to locations.