## Stripe Terminal: In-Person Payment Solutions

This documentation set provides comprehensive guidance on implementing and managing 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's capabilities, its role in unifying online and in-person payments, and integration options.
*   **Get Started: Use Cases:** Demonstrates how to accept in-person payments for a direct retail business, outlining the necessary steps and recommended hardware.
*   **Design an Integration:** Guides users through selecting the right reader and integration type (server-driven, SDK-based) for their specific needs.
*   **Example Applications:** Provides sample applications and simulated readers to help developers understand the interactions within a Terminal integration.
*   **Deployment Checklist:** A comprehensive checklist to ensure a smooth deployment of a Stripe Terminal integration.
*   **Terminal Network Requirements:** Details the network configurations necessary for Terminal readers and integrations to function correctly.

### Readers and Hardware

*   **Select Your Reader:** A guide to choosing the appropriate Stripe Terminal reader based on integration type and physical sales environment.
*   **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.
*   **Stripe Reader M2:** Setup and reference information for the Stripe Reader M2 mobile reader.
*   **BBPOS Chipper 2X BT:** Information on the BBPOS Chipper 2X BT mobile reader (note: no longer available for purchase).
*   **Verifone Readers (M425, P400, P630, UX700, V660p):** Setup, troubleshooting, and accessory information for various Verifone readers.
*   **Tap to Pay:** Information on accepting contactless payments directly on compatible iPhone and Android devices.
*   **Stripe Terminal Reader Product Sheets:** Technical specifications for all supported Stripe Terminal hardware.
*   **Place Hardware Orders:** Instructions on how to order readers and accessories from the Stripe Dashboard.
*   **Submit a Warranty Claim:** Guidance on initiating warranty claims for defective readers.

### Integration and Features

*   **Set Up Your Integration:** Instructions for setting up either an SDK-based or server-driven integration.
*   **Collect Card Payments:** Details on preparing your application to collect card payments using Stripe Terminal.
*   **Offline Payments:** How to accept payments even when internet connectivity is interrupted.
*   **Collect Swiped Data:** Information on using the Terminal SDK to read non-PCI data like gift cards via magstripe.
*   **Collect On-Screen Inputs:** Utilizing smart reader screens to collect customer information.
*   **Collect Tapped Data for NFC Instruments:** Reading unique identifiers from NFC instruments.
*   **Display Cart Details:** Dynamically updating the reader screen with line items and total prices.
*   **Provide Receipts:** Options for providing compliant physical or email receipts to customers.
*   **Refund Transactions:** How to cancel or refund Stripe Terminal payments.
*   **Extended Authorizations:** Capturing confirmed Stripe Terminal payments up to 30 days later.
*   **Collect and Save Payment Details:** Methods for collecting and securely storing payment details for future use.
*   **Mail Order and Telephone Order (MOTO) Payments:** Processing payments taken over the phone or by mail.
*   **Collect Tips:** Options for collecting tips, including on-reader and on-receipt methods.
*   **Additional Payment Methods:** Accepting QR code-based payment methods like WeChat Pay and Affirm.
*   **Use Terminal with Connect:** Integrating Stripe Terminal with your Connect platform for multiparty payments.

### Apps on Devices

*   **Apps on Devices Overview:** An introduction to deploying your POS applications on Stripe smart readers.
*   **Build and Test Your App:** Guidance on developing and testing applications using a DevKit.
*   **Prepare for App Review:** Steps to ensure your app meets Stripe's review process requirements.
*   **Submit Your App:** How to upload your application to Stripe for review and deployment.
*   **Deploy Your App in the Dashboard:** Instructions for deploying approved apps via the Stripe Dashboard.
*   **Deploy Your App with the API:** Using webhooks and the API to deploy your Android app to devices.
*   **Monitor Your Deployment:** Tools and methods for tracking the status of deployed applications.
*   **Troubleshoot Apps on Devices:** Resolving common issues encountered during app deployment and operation.

### Reader Management and Configuration

*   **Manage Locations and Zones:** Grouping and managing readers by physical location for streamlined operations.
*   **Register Readers:** The process of associating readers with specific locations.
*   **Configure Offline Mode:** Enabling or disabling offline payment collection capabilities.
*   **Configure WiFi Network:** Remotely managing WiFi network settings for smart readers.
*   **Configure Cellular Network:** Setting up cellular connectivity for compatible readers (e.g., Stripe Reader S710).
*   **Terminal Configurations:** Applying various settings (splash screen, tipping, etc.) to readers at account or location levels.
*   **Configure the Admin Menu Passcode:** Securing access to the reader's admin menu.
*   **Configure the Reboot Time Window:** Customizing the schedule for smart reader reboots to avoid service interruptions.
*   **Configure On-Reader Tips:** Customizing the tipping options displayed on readers.
*   **Configure Readers with a Custom Splash Screen:** Personalizing the default screen displayed on readers.
*   **Monitor Readers:** Accessing real-time status and insights for your Stripe Terminal devices.

### Developer Resources

*   **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).
*   **Testing Stripe Terminal:** Strategies and tools for effectively testing your Terminal integration.