Bolt Connection

A Bolt Connection represents a connection between your server and a Beam Bolt device. It is specific to Pairing Mode, where your server sends payment requests to the connected device. You do not need one in Standalone Mode or Deep Link Mode.

You create a Bolt Connection by sending the Pairing Code shown on the device to the Bolt Connection API. The Pairing Code is displayed on the device together with the time it expires, so pair the device before that time passes.

What a Bolt Connection contains

• id: the Bolt Connection ID. You pass this as boltConnectionId when you create a Bolt Intent, so store it on your server.
• deviceId: the Beam Bolt device this connection belongs to. Store it too, so you can tell your devices apart.
• merchantId: your merchant account.
• createdAt: when the connection was created.

Lifetime

A Bolt Connection lasts until you delete it. There is nothing to refresh and nothing to renew, so your server can keep using the same boltConnectionId for every payment request to that device.

Each device can have only one connection at a time, but there is no limit on how many connections your server can have across devices.

When you delete a Bolt Connection, the device is logged out and has to log in again. See Disconnecting from a device.

If you are unsure whether a connection is still usable, read it back with the Get Bolt Connection API before you send a payment request. For the errors these calls can return, see Error Handling.