## Stripe Terminal: In-Person Payment Solutions

This documentation suite provides comprehensive guidance on implementing and managing Stripe Terminal, Stripe's solution for accepting in-person payments. It covers everything from initial setup and integration to advanced features and device management.

---

### Core Concepts & Getting Started

*   **Overview:** Understand what Stripe Terminal is, its benefits, and how it unifies online and in-person payment systems. Learn about its features, availability, and integration options.
*   **Use Cases:** Explore common scenarios for using Stripe Terminal, such as accepting payments for direct retail businesses.
*   **Integration Design:** Learn how to choose the right reader and integration type (server-driven, SDK-based) for your business needs.
*   **Example Applications:** Get hands-on experience with Stripe Terminal by using provided example applications and simulated readers.
*   **Deployment Checklist:** Ensure a smooth deployment of your Stripe Terminal integration by following a comprehensive checklist.

---

### Readers and Hardware

*   **Select Your Reader:** Compare different Stripe Terminal readers (e.g., Stripe Reader S700/S710, BBPOS WisePOS E, BBPOS WisePad 3, Verifone models) and Tap to Pay options to find the best fit for your business.
*   **Reader Setup:** Detailed guides are available for setting up specific readers:
    *   Stripe Reader S700/S710
    *   BBPOS WisePOS E
    *   BBPOS WisePad 3
    *   BBPOS Chipper 2X BT (No longer supported for purchase)
    *   Verifone Readers (M425, P400, P630, UX700, V660p)
    *   Tap to Pay on iPhone and Android
*   **Accessories:** Information on available accessories for Stripe Reader S700/S710 and Verifone readers.
*   **Hardware Orders:** Learn how to place orders for reader hardware and accessories.
*   **Warranty Claims:** Instructions on how to submit warranty claims for defective readers.

---

### Integration and Development

*   **Design a Custom POS Integration:** Guidance on building a tailored point-of-sale integration.
*   **Server-Driven Integration:** Understand how to use the Stripe API for direct communication with smart readers.
*   **SDK Integrations:** Information on using the JavaScript, iOS, Android, and React Native SDKs.
*   **Terminal Network Requirements:** Essential information about network configurations for a stable Terminal integration.
*   **SDK Migration Guides:** Resources for migrating between different versions of the Stripe Terminal SDKs (v3, v4, v5).
*   **JavaScript API Reference:** Detailed documentation for the Stripe Terminal JavaScript SDK.

---

### Features and Functionality

*   **Accepting Payments:**
    *   **Collect Card Payments:** Guides on processing standard card payments.
    *   **Additional Payment Methods:** Support for QR code-based payments like WeChat Pay, Affirm, and PayNow.
    *   **Offline Payments:** How to collect payments even with intermittent internet connectivity.
    *   **Mail Order and Telephone Order (MOTO) Payments:** Process payments taken over the phone or by mail.
*   **Reader Display and Input:**
    *   **Display Cart Details:** Dynamically update the reader screen with transaction information.
    *   **Collect On-Screen Inputs:** Gather customer information directly on the reader.
    *   **Collect Swiped Data:** Read non-PCI data using the magnetic stripe reader.
    *   **Collect Tapped Data for NFC Instruments:** Read unique identifiers from NFC instruments.
*   **Payment Management:**
    *   **Extended Authorizations:** Capture confirmed payments at a later time.
    *   **Refund Transactions:** Process cancellations or refunds for Terminal payments.
    *   **Provide Receipts:** Options for offering compliant physical or email receipts.
*   **Customer Data and Loyalty:**
    *   **Collect and Save Payment Details:** Securely store payment methods for returning customers.
    *   **Save Payment Details After Payment:** Capture and store payment details from an in-store purchase for future online use.
    *   **Save Directly Without Charging:** Collect card details for online use without immediately charging the card.
*   **Tips:**
    *   **Collect Tips:** Learn about collecting tips before or after payment.
    *   **Collect On-Reader Tips:** Configure suggested tip amounts to display on the reader.
*   **Apps on Devices:**
    *   **Overview:** Deploy and manage your POS applications directly on Stripe smart readers.
    *   **Build and Test Your App:** Develop and test applications using a DevKit.
    *   **Prepare for App Review:** Understand the process for app review.
    *   **Submit Your App:** Upload your application to Stripe.
    *   **Deploy Your App:** Deploy your approved app via the Dashboard or API.
    *   **Monitor Your Deployment:** Track the status and troubleshoot app deployments.
    *   **Troubleshoot Apps on Devices:** Resolve common issues with app deployment.

---

### Device Management and Configuration

*   **Manage Readers:** Overview of managing your fleet of Stripe Terminal devices.
*   **Register Readers:** Steps to register readers to a specific location.
*   **Manage Locations and Zones:** Group and manage readers by physical location for easier administration.
*   **Configure Readers:** Apply various settings to your readers:
    *   **Terminal Configurations:** Use the Terminal Configurations object for account-level or location-level settings.
    *   **Admin Menu Passcode:** Secure access to reader settings.
    *   **Cellular Network:** Configure cellular connectivity for supported readers.
    *   **Offline Mode:** Enable or disable offline payment collection.
    *   **Reboot Time Window:** Customize the device reboot schedule.
    *   **Splash Screen:** Set a custom default screen for your readers.
    *   **Tipping:** Configure on-reader tipping options.
    *   **WiFi Network:** Remotely configure WiFi networks for smart readers.
*   **Monitor Readers:** Access real-time status and insights for your Stripe Terminal devices.

---

### Testing and Troubleshooting

*   **Test Stripe Terminal:** Learn how to effectively test your Terminal integration using simulators and physical test cards.
*   **Troubleshoot Readers:** Specific troubleshooting guides for various reader models (M425, P630, UX700, V660p).
*   **Troubleshoot Apps on Devices:** Resolve issues related to deploying applications on readers.

---

### Advanced Topics

*   **Use Terminal with Connect:** Integrate Stripe Terminal with your Connect platform for multiparty payments.
*   **Regional Considerations:** Understand country-specific requirements for Terminal integrations.
*   **Global Availability:** Information on where Terminal is available and supported payment methods.