Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Overview
What is Terminal
Design an integration
Example applications
Quickstart
Accept an in-person payment
Set up your reader
Set up your integration
Connect to a reader
Collect payments
Regional considerations
Terminal payments features
Multiparty payments with Connect
Collect tips
Save cards for future use
Refund transactions
Provide receipts
Cart display
Incremental authorizations
Extended authorizations
Deploy at scale
Order hardware
Manage locations
Configure readers
References
API references
Bluetooth readers
Smart readers
SDK migration guide
Testing
Deployment checklist
Stripe Terminal reader product sheets
Testing
No-code options
terminal
·
HomePaymentsIn-person payments

Configure readers with a custom splash screen

Customize the default splash screen for your readers.

After you order and register readers to your Stripe account, you can configure them with a custom splash screen to match your brand.

A splash screen is the default screen that displays when your BBPOS WisePOS E or Verifone P400 is ready to accept payments. You can set a custom splash screen for these readers in one of two ways:

  • In the Dashboard
  • Using the Configuration API

To customize the BBPOS WisePad 3 or BBPOS Chipper 2X BT checkout experience, modify the UI of your application directly.

In the Dashboard

Use the Dashboard to set a custom splash screen for your BBPOS WisePOS E or Verifone P400.

  1. From the Readers section of the Dashboard, click your default location.
  2. In the location details, click Reader settings.
  3. Upload an image to display on your readers. JPG and PNG images must be less than 2MB. GIF images must be less than 4 MB. Each reader has a specific display resolution and you must crop your JPG or PNG image to fit those dimensions. GIF images scale automatically.

Only BBPOS WisePOS E readers can use GIF images for the splash screen.

ReaderResolution (W x H)
BBPOS WisePOS E720 x 1280
Verifone P400320 x 480

After uploading, it can take several minutes for the splash screen to appear.

You can also customize the splash screen for each location, so that all readers registered to a site share the same branding. For Connect users, custom splash screens enable you to create different checkout experiences to reflect the various merchants connected to your platform.

Using the Configuration API

Use the Configuration API to specify settings and set a custom splash screen for your BBPOS WisePOS E or Verifone P400.

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

Upload a file

Use the File Upload API to upload an image to display on your readers. JPG and PNG images must be less than 2MB. GIF images must be less than 4 MB. Each reader has a specific display resolution and you must crop your JPG or PNG image to fit those dimensions. GIF images scale automatically.

Only BBPOS WisePOS E readers can use GIF images for the splash screen.

ReaderResolution (W x H)
BBPOS WisePOS E720 x 1280
Verifone P400320 x 480
Terminal
curl https://api.stripe.com/v1/files \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -F "file"="@/path/to/a/file.jpg" \ -F "purpose"="reader_splashscreen"

Create or update a Configuration object

Use a Configuration object to set the custom splash screen for your specified device type. The supported device types are bbpos_wisepos_e and verifone_p400.

Stripe automatically provisions an account default configuration for you. You can optionally create a Configuration object for another configuration, or you can continue to the next step to apply the default configuration settings to the entire account.

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

curl https://api.stripe.com/v1/terminal/configurations \ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "bbpos_wisepos_e[splashscreen]"=file_1KjBJdE7XUJuZdf0F6GgO9uY

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 "bbpos_wisepos_e[splashscreen]"=file_1KjBJdE7XUJuZdf0F6GgO9uY

Assign a Configuration object

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:

Configuration Hierarchy

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

Update the default account configuration

Stripe automatically provisions the default configuration for your account. When you set up your hierarchy, any setting that isn’t established at the location level inherits the setting from the default configuration. You can’t apply the default configuration directly to a location.

To retrieve the default configuration:

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

After you retrieve the default configuration, you can update it as you would any other configuration.

Was this page helpful?
Questions? Contact us.
View developer tutorials on YouTube.
Check out our product changelog.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
In the Dashboard
Using the Configuration API
Upload a file
Create or update a Configuration object
Assign a Configuration object
Update the default account configuration
Stripe Shell
Test mode
▗▄ ▄▟█ █▀▀ ▗▟████▙▖ ██████ ███▗▟█ ███ ███▗▟██▙▖ ▗▟█████▙▖ ███▖ ▀▀ ███ ███▀▀▀ ███ ███▀ ███ ███ ███ ▝▜████▙▖ ███ ███ ███ ███ ███ █████████ ▄▄ ▝███ ███ ▄ ███ ███ ███▄ ███ ███ ▄▄ ▝▜████▛▘ ▝▜███▛ ███ ███ ███▝▜██▛▘ ▝▜█████▛▘ ███ ▀▘
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to Stripe docs and press Control + Backtick on your keyboard to start managing your Stripe resources in test mode. - View supported commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$