Configure the reboot time window

Beta

By default, BBPOS WisePOS E and Stripe Reader S700 readers reboot every 24 hours at midnight. If your business is open or processing payments during this time, you might want to set a custom reboot window to avoid any interruptions.

Use the Configuration API

Terminal Configuration objects follow a hierarchical approach. You can set configurations as follows:

• On individual Locations – Applies to all readers registered to that location
• At the account level – Applies to all readers in your fleet

Configurations are hierarchical and location-level settings can override account-level settings. Settings that aren’t configured at the location inherit the account-level settings.

For example, you can model your Configuration objects as follows:

Configure the account default reboot time window

1. Retrieve the account default Configuration object.
2. Update the account default Configuration object.

To retrieve the default configuration:

curl -G https://api.stripe.com/v1/terminal/configurations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d is_account_default=true

To update a Configuration object, use the Configuration Update request:

curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "reboot_window[start_hour]"=1 \
  -d "reboot_window[end_hour]"=3

• start_hour - Integer between 0 to 23 that represents the start hour of the reboot time window.
• end_hour - Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.

If start_hour is less than end_hour, we consider them as values for the same day. If start_hour is greater than end_hour, we consider the end_hour a value for the next day. In the code snippet above, the devices are scheduled to reboot anytime between 1 am to 3 am. As another example, if you specify the reboot window as [start_hour: 15, end_hour: 3], the devices will reboot anytime between 3 pm to 3 am.

Configure the reboot time window for individual locations

1. Create or update a Configuration object.
2. Assign the Configuration to a Location.

To create a Configuration object, use the Configuration Create request:

curl https://api.stripe.com/v1/terminal/configurations \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "reboot_window[start_hour]"=1 \
  -d "reboot_window[end_hour]"=3

To update a Configuration object, use the Configuration Update request:

curl https://api.stripe.com/v1/terminal/configurations/tmc_EjHtMwLT8HmATT \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "reboot_window[start_hour]"=1 \
  -d "reboot_window[end_hour]"=3

To assign a configuration to a location, provide the Configuration object you created earlier:

curl https://api.stripe.com/v1/terminal/locations/tml_DPJxAAnxbn3JQz \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d configuration_overrides=tmc_EjHtMwLT8HmATT