Skip to content
Last updated

Set-Up Terminal

Overview

This guide provides a step-by-step process for setting up your in-person payment terminal at your physical location. Proper setup is essential to ensure that the terminal functions correctly and securely processes payments.

Initial Setup

Once the terminal has arrived, you can turn it on and connect it to your Wi-Fi network.

In order to register the device with your Ryft account, you will need to obtain the serial number. This should be printed on the underside of the terminal.

You can also use our API to programmatically register terminals.

Create a Location

All terminals must be registered to a specific location. A location simply represents the physical address where the terminal will be used.

To create a new location, you can follow these steps in the Portal:

  1. Head to the terminal location management area of your account.
  2. Click Add within the Locations section.
  3. On the next screen, enter the full address for the location, and click Add Location once done.
  4. The location will be successfully created, and its unique ID will be visible directly below the address.

Once a location has been created, you can proceed to linking your terminal to it.

Once you've configured at least one location, you can link your terminal device to it by following these steps:

  1. Head to the terminal management area of your account.
  2. Click Add within the Devices section.
  3. On the next screen, enter the serial number of the terminal. You may also optionally add a name to help identify the device.
  4. Select the location you created in the previous step.
  5. Click Register Device to finish setting it up.
  6. The device will be created, and its unique ID will be visible directly below the serial number.

Remember the ID (starting with tml_). You will need this unique Identifer to communicate with the terminal.

Now that your terminal is registered and linked to a location, it is ready to start accepting in-person payments.

Next Steps

You can follow the instructions in the Accepting Payments guide to start processing in-person payments using your configured terminal.