## Stripe Terminal: In-Person Payment Solutions

This documentation set provides comprehensive guidance on integrating and utilizing Stripe Terminal for accepting in-person payments. It covers everything from initial setup and integration design to advanced features, reader management, and troubleshooting.

---

### Core Concepts & Getting Started

*   **Accept In-Person Payments with Terminal:** An overview of Stripe Terminal, its capabilities, and how it unifies online and in-person payment management. It introduces the concept of choosing readers and integration options.
*   **Get Started: Use Cases for In-Person Payments:** This section focuses on specific scenarios for accepting in-person payments, particularly for direct retail businesses, and outlines the necessary steps for integration.
*   **Design an Integration:** Guides users through the process of selecting the right reader and integration type (server-driven, SDK-based) for their specific needs. It details reader options like the Stripe Reader S700/S710.
*   **Example Applications:** Provides practical examples and a sample integration to help developers understand the interactions between Terminal SDKs, readers, and their point-of-sale applications.
*   **Deployment Checklist:** A comprehensive checklist to ensure a smooth and successful deployment of Stripe Terminal, covering critical hardware and software integration steps.

---

### Reader Management & Configuration

*   **Select Your Reader:** Helps users choose the appropriate Stripe Terminal reader based on their integration type and physical sales environment.
*   **Set Up Readers:** Detailed guides for setting up various Stripe Terminal readers, including:
    *   Stripe Reader S700/S710
    *   BBPOS WisePOS E
    *   BBPOS WisePad 3
    *   BBPOS Chipper 2X BT (Note: No longer available for purchase)
    *   Stripe Reader M2
    *   Verifone Readers (M425, P400 (No longer available), P630, UX700, V660p)
    *   Tap to Pay on iPhone and Android
*   **Place Hardware Orders:** Instructions on how to order reader hardware and accessories from the Stripe Dashboard.
*   **Register Readers:** Explains the process of registering readers to a location, which is essential for accepting payments.
*   **Manage Locations and Zones:** Provides guidance on grouping and managing readers by physical location for streamlined operations, especially for businesses with multiple sites or connected accounts.
*   **Terminal Configurations:** Details how to use the Terminal Configurations object to apply settings (e.g., splash screen, tipping, offline mode) at the account or location level.
    *   **Configure Admin Menu Passcode:** Securing reader access with custom passcodes.
    *   **Configure Cellular Network:** Setting up cellular connectivity for compatible readers.
    *   **Configure Offline Mode:** Enabling or disabling offline payment collection.
    *   **Configure Reboot Time Window:** Customizing reader reboot schedules to avoid service interruptions.
    *   **Configure Splash Screen:** Personalizing the default screen displayed on readers.
    *   **Configure Tipping:** Customizing on-reader tipping options.
    *   **Configure WiFi Network:** Remotely managing WiFi network settings for smart readers.
*   **Monitor Readers:** Instructions on accessing real-time status, health, and operational data for Stripe Terminal devices.
*   **Submit a Warranty Claim:** Guide on submitting claims for defective readers.

---

### Core Payment Functionality

*   **Collect Card Payments:** Covers the process of preparing applications and backends to collect card payments using Stripe Terminal.
*   **Accept Offline Payments:** Explains how Stripe Terminal allows storing payments locally during internet connectivity issues and automatically forwarding them when the connection is restored.
    *   **Collect card payments while offline:** Specific details on offline payment collection.
*   **Extended Authorizations:** Allows capturing confirmed Stripe Terminal payments up to 30 days later, useful for scenarios like hotel check-ins.
*   **Mail Order and Telephone Order (MOTO) Payments:** Guides on processing payments taken over the phone or by mail using a Stripe Terminal reader.
    *   **Process MOTO payments:** Detailed steps for processing MOTO transactions.
    *   **Save a card with MOTO for future payments:** How to save MOTO card details for future use.
*   **Additional Payment Methods:** Information on accepting QR code-based payment methods like WeChat Pay, Affirm, and PayNow.
*   **Provide Receipts:** Instructions on offering compliant physical or email receipts to customers.

---

### Advanced Features & Data Collection

*   **Collect on-screen inputs:** Enables collecting customer information directly on smart reader displays.
*   **Collect swiped data:** Details on using reader hardware interfaces to collect non-PCI data, such as gift card information.
*   **Collect tapped data for NFC instruments:** Using the reader's contactless interface to read unique identifiers from NFC instruments.
*   **Collect and save payment details for future use:** Methods for collecting and storing payment information for returning customers, including:
    *   **Save directly without charging:** Using SetupIntents to collect card details without immediate charging.
    *   **Save payment details after payment:** Saving payment details from an in-store purchase for later use.
*   **Collect tips:** Explains different methods for collecting tips, including on-receipt and on-reader tipping.
    *   **Collect on-reader tips:** Displaying suggested tip amounts on the reader before payment.
*   **Display cart details:** Dynamically updating cart details on the reader screen during checkout.
*   **Refund transactions:** How to cancel or refund Stripe Terminal payments.
*   **Use Terminal with Connect:** Integrating Stripe Terminal with your Connect platform for multiparty payments.

---

### App Development & Deployment

*   **Apps on Devices:** An overview of deploying your point-of-sale (POS) application on Stripe smart readers.
    *   **Build and test your app:** Guidance on developing and testing applications using a DevKit.
    *   **Prepare for app review:** Steps to prepare your app for Stripe's review process.
    *   **Submit your app:** How to upload your Android app to Stripe.
    *   **Deploy your app in the Dashboard:** Instructions for deploying apps via the Stripe Dashboard.
    *   **Deploy your app with the API:** Details on deploying Android apps via webhooks.
    *   **Monitor your deployment:** How to track app deployment progress and troubleshoot issues.
    *   **Troubleshoot apps on devices:** Resolving common issues with app uploads and deployments.

---

### SDKs & References

*   **Terminal Network Requirements:** Essential information on network configurations needed for Stripe Terminal to function correctly.
*   **Stripe Terminal reader product sheets:** Links to detailed hardware specifications for each reader.
*   **JavaScript API reference:** Documentation for the Stripe Terminal JavaScript SDK.
*   **Terminal SDK Migration Guides:** Guides for migrating between different versions of the Stripe Terminal SDKs (v3, v4, v5).
*   **Test Stripe Terminal:** Strategies and tools for effectively testing your Terminal integration, including reader simulators and test cards.