Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Handle multiple currencies
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
    Overview
    Accept in-person payments
    Integration design
    Select your reader
    Design an integration
    Quickstart
    Example applications
    Testing
    Terminal setup
    Set up your integration
    Connect to a reader
    Accepting a payment
    Collect card payments
    Additional payment methods
    Accept offline payments
    Mail order and telephone order payments
    Regional considerations
    During checkout
    Collect tips
    Collect and save payment details for future use
    Flexible authorizations
    After checkout
    Refund transactions
    Provide receipts
    Customize checkout
    Cart display
    Collect on-screen inputs
    Collect swiped data
    Collect tapped data for NFC instruments
    Apps on devices
    Manage readers
    Order, return, replace readers
    Register readers
    Manage locations and zones
    Configure readers
    Monitor Readers
    Encryption
    References
    API references
    Mobile readers
    Smart readers
    SDK migration guide
    Deployment checklist
    Stripe Terminal reader product sheets
Beyond payments
Incorporate your company
Crypto
Financial Connections
Climate
Understand fraud
Radar fraud protection
Manage disputes
Verify identities
HomePaymentsTerminal

Monitor readers

Access real-time status and insights for your Stripe Terminal devices.

You can monitor and track the performance, health, and operational data of your Stripe Terminal devices using the Stripe Dashboard.

Readers list

Use the Readers list in the Stripe Dashboard to view all registered readers in your account. You can apply filters to view a subset of your readers. Additionally, you can export this list for use outside of Stripe.

For platforms or marketplaces using Terminal with Connect, if you use direct charges with readers owned by connected accounts, you must log in as a connected account to view the list of its readers.

Reader details

The Reader details page displays information about a particular terminal device. To open it, click the reader in the Readers list.

The reader information section includes the following details:

  • Connection state (online or offline)
  • Reader type
  • Reader ID
  • Registration date
  • P2PE status
  • Assigned location
  • Battery life
  • Last active time
  • Currently installed software version

The device connectivity information section includes the following details:

  • Ethernet
    • MAC address
    • IP address
    • Connection status if present
  • WiFi
    • MAC address
    • IP address
    • SSID
    • Frequency
    • Signal strength
    • Connection status if present
  • Bluetooth
    • MAC address

Learn more about network requirements and troubleshooting at Terminal network requirements.

The page also displays a summary of recent payments processed by the reader, including details about successful payments and any errors. You can’t filter or export this summary. You can use the Transactions page to view all your customer payments, including the Terminal location and Terminal reader that processed each transaction. You can filter and export this transactions list.

Reader events Public preview

The reader event log displays the last 30 days of events related to the reader, such as software updates, network disconnections, and boot-ups. Events can take several minutes to appear in the log.

Note

Your account level time zone setting determines the reader event time zone.

The following table describes the reader events that can appear in the log, including their types and sub-types.

Event typeSub-typeDetails
GeneralDevice powered onThis event is delivered after the reader completes all boot activities. Each event includes the restart reason. Reader software versions earlier than 2.33 are more likely to show an “unknown” reason.
Network connectivityNetwork connectedThis event is delivered when the reader connects to a network. Each event includes the connection type (WiFi or Ethernet) and the SSID for WiFi connections.
Network connectivityNetwork disconnectedThis event is delivered when the reader disconnects from a network. Each event includes the connection type. For more information on network troubleshooting, refer to Terminal network requirements.
Update operationUpdate install succeededThis event is delivered when the reader successfully installs new software. Each event includes the software and version installed.
Update operationUpdates deferredThis event is delivered when one or more software updates are deferred. Each event includes the software, versions deferred, and the reason for the deferral. This might happen due to user action or insufficient battery charge.
Update operationUpdate install failedThis event is delivered when a software update fails. Each event includes the software and version that failed to install. The system will retry the installation during the configured reboot time window. You can manually trigger a retry by rebooting the device. Before rebooting, make sure that the reader’s battery is sufficiently charged to complete the update. For additional smart reader troubleshooting, refer to our support docs.
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc