## Stripe Terminal: In-Person Payments Documentation

This documentation suite provides comprehensive guidance on implementing and managing Stripe Terminal for in-person payment acceptance. It covers everything from initial setup and integration design to advanced features and fleet management.

### Getting Started

*   **Accept in-person payments for a direct retail business**: Learn the fundamental steps to integrate Stripe Terminal for your retail business, including setting up your Stripe account, ordering readers, and understanding server-driven integrations.
*   **Terminal Overview**: Get a high-level understanding of Stripe Terminal, its capabilities, and how it unifies online and in-person payment management.
*   **Design an integration**: Explore different integration options, choose the right reader for your needs, and understand the overall architecture of a Stripe Terminal integration.
*   **Example applications**: Discover and utilize example applications to familiarize yourself with the interactions between Terminal SDKs, readers, and your point-of-sale system.
*   **Deployment checklist**: Ensure a smooth deployment by following a comprehensive checklist that covers critical hardware and software integration steps.

### Core Features and Functionality

*   **Collecting Payments**:
    *   **Collect card payments**: Learn how to prepare your application and backend to process card payments using Stripe Terminal, including server-driven and SDK-based approaches.
    *   **Accept offline payments**: Understand how Stripe Terminal allows you to store payments locally during internet connectivity issues and automatically forward them once a connection is restored.
    *   **Collect tapped data for NFC instruments**: Utilize the Terminal SDK to read unique identifiers from NFC instruments like cards or wristbands.
    *   **Collect swiped data**: Explore the use of Terminal for collecting non-PCI data with reader hardware interfaces, such as gift cards.
    *   **Collect on-screen inputs**: Learn how to display input forms on smart readers to collect information from customers, such as loyalty identifiers or waiver acknowledgments.
    *   **Additional payment methods**: Discover how to accept QR code-based payment methods like WeChat Pay, Affirm, and PayNow in addition to cards.
*   **Reader Management and Configuration**:
    *   **Select your reader**: Compare available Stripe Terminal readers and Tap to Pay options to choose the best fit for your integration.
    *   **Set up your integration**: Get started with setting up either an SDK-based or server-driven integration for in-person payments.
    *   **Connect to a reader**: Learn how to establish a connection between your application and a Stripe Terminal reader, including using simulated readers for development.
    *   **Register readers**: Understand the process of registering your readers to a location to enable payment acceptance.
    *   **Manage locations and zones**: Streamline the management of multiple readers across different physical sites by organizing them into locations and zones.
    *   **Monitor readers**: Access real-time status and insights for your Stripe Terminal devices through the Stripe Dashboard.
    *   **Configure offline mode**: Enable or disable offline mode on your readers to manage payments during network interruptions.
    *   **Configure the admin menu passcode**: Customize the admin menu passcode for enhanced security on your smart readers.
    *   **Configure readers with a custom splash screen**: Personalize the default screen displayed on your readers.
    *   **Configure the WiFi network**: Remotely manage WiFi network settings for your smart readers.
    *   **Configure the cellular network**: Remotely configure cellular network settings for compatible readers (Stripe Reader S710).
    *   **Configure on-reader tips**: Customize the tipping options displayed on your readers to collect tips from customers.
    *   **Configure the reboot time window**: Set a custom reboot time for your readers to avoid payment interruptions.
    *   **Terminal configurations**: Utilize the Terminal Configurations object to apply various settings to your readers at the account or location level.
*   **Advanced Features**:
    *   **Collect and save payment details for future use**: Learn how to collect and securely save payment methods for returning customers, enabling online reuse.
    *   **Extended authorizations**: Capture confirmed Stripe Terminal payments up to 30 days later for scenarios requiring longer authorization periods.
    *   **Mail order and telephone order (MOTO) payments**: Process payments taken over the phone or by mail by entering card details on a Stripe Terminal reader.
    *   **Provide receipts**: Implement compliant physical or email receipts for your customers.
    *   **Refund transactions**: Cancel or refund Stripe Terminal payments through the SDK or Dashboard.
    *   **Display cart details**: Dynamically update cart details on the reader screen during the checkout process.
    *   **Print content on a reader**: Print custom content like receipts or tickets directly on compatible readers with embedded printers.
    *   **Apps on Devices**: Learn about deploying and managing your point-of-sale (POS) applications on Stripe smart readers.
        *   **Build and test your app**: Develop and test your application using a DevKit device.
        *   **Prepare for app review**: Understand Stripe's app review process for security and compliance.
        *   **Submit your app**: Learn how to upload your Android app to Stripe for deployment.
        *   **Deploy your app in the Dashboard**: Deploy your approved Android app to your devices through the Stripe Dashboard.
        *   **Deploy your app with the API**: Deploy your approved Android app to your devices via a webhook.
        *   **Monitor your deployment**: Track the progress of your app deployments and troubleshoot any issues.
    *   **Use Terminal with Connect**: Integrate Stripe Terminal with your Connect platform to enable in-person payments for your connected accounts.
    *   **Collect payments on readers with standalone mode**: Accept in-person payments directly on smart readers without building a custom POS.

### Reader Specific Information

*   **Stripe Reader S700/S710**: Detailed information and setup guides for the S700 and S710 smart readers.
*   **BBPOS WisePOS E**: Setup and reference information for the BBPOS WisePOS E countertop reader.
*   **BBPOS WisePad 3**: Setup and reference information for the BBPOS WisePad 3 handheld reader.
*   **BBPOS Chipper 2X BT**: Information on the BBPOS Chipper 2X BT mobile reader (note: no longer available for purchase).
*   **Stripe Reader M2**: Setup and reference information for the Stripe Reader M2 mobile reader.
*   **Verifone Readers**: Information on setting up and troubleshooting various Verifone readers (M425, P400, P630, UX700, V660p).
*   **Tap to Pay**: Learn how to accept contactless payments on compatible iPhone and Android devices.

### Technical References and Guides

*   **JavaScript API reference**: Navigate the Stripe Terminal JavaScript SDK.
*   **Terminal SDK migration guides**: Find guides for migrating between different versions of the Stripe Terminal SDKs (v3, v4, v5).
*   **Stripe Terminal reader product sheets**: Access detailed hardware specifications for all supported readers.
*   **Terminal network requirements**: Ensure your network is configured correctly for Stripe Terminal to function optimally.

### Support and Troubleshooting

*   **Troubleshoot apps on devices**: Resolve common issues related to uploading and deploying applications on Stripe Terminal devices.
*   **Troubleshoot specific readers**: Find troubleshooting steps for individual reader models (e.g., M425, P630, UX700, V660p).
*   **Submit a warranty claim**: Learn how to submit claims for defective readers.
*   **Place hardware orders**: Order reader hardware and accessories from your Stripe Dashboard.