terminal_reader_hardware_fault
Call a Pro
Stripe · Payments API
Reader reported unrecoverable hardware fault and cannot accept payments.
Quick Answer
Error code terminal_reader_hardware_fault on your Stripe Payments API means: Reader reported unrecoverable hardware fault and cannot accept payments.. This is usually fixable — see the step-by-step guide below.
Affected Models
Applies to all models
Likely Causes
How to Fix It
1
Stripe: Capture request IDs and timestamps to correlate with provider incident data.
2
Retry with backoff and idempotency protection for transient server-side faults.
3
Check provider status dashboard and regional service health announcements.
4
Fail over non-critical workloads when sustained internal errors persist.
5
Escalate with full request metadata if failure pattern remains stable over time.
Pro Tip
This issue typically requires professional diagnosis. Attempting this fix without proper training could cause further problems.
Related Error Codes