# Stripe Terminal: In-Person Payment Solutions

This documentation set provides comprehensive guidance on implementing and managing Stripe Terminal for in-person payment processing. It covers everything from initial setup and integration design to advanced features, reader management, and troubleshooting.

## Key Areas

This documentation is organized into the following key areas:

### Getting Started with In-Person Payments

*   **Accepting In-Person Payments:** An overview of Stripe Terminal and its capabilities for businesses to accept in-person payments.
*   **Use Cases:** Explore common scenarios where Stripe Terminal can be beneficial, such as for direct retail businesses.
*   **Integration Design:** Guidance on selecting the right reader and designing your integration, including server-driven and SDK-based approaches.
*   **Example Applications:** Utilize provided example applications to understand the interactions within a Terminal integration.
*   **Deployment Checklist:** A comprehensive checklist to ensure a smooth deployment of your Stripe Terminal integration.

### Readers and Hardware

*   **Select Your Reader:** Information on choosing the appropriate Stripe Terminal reader for your business needs.
*   **Reader Setup:** Detailed instructions 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)
    *   Verifone Readers (M425, P400, P630, UX700, V660p)
    *   Tap to Pay on iPhone and Android
*   **Hardware Orders:** How to place orders for reader hardware and accessories.
*   **Reader Management:**
    *   Registering readers to locations.
    *   Managing locations and zones for organizing readers.
    *   Monitoring reader status and performance.
    *   Ordering, returning, and replacing readers.
    *   Submitting warranty claims.

### Core Payment Features

*   **Collecting Card Payments:** The fundamental process of collecting card payments using Stripe Terminal.
*   **Offline Payments:** How to accept payments even when internet connectivity is an issue.
*   **Additional Payment Methods:** Support for payment methods beyond traditional cards, such as QR code-based payments (WeChat Pay, Affirm, PayNow).
*   **Mail Order and Telephone Order (MOTO) Payments:** Processing payments taken over the phone or by mail.
*   **Saving Payment Details:** Options to collect and save customer payment details for future use.
*   **Extended Authorizations:** Capturing confirmed Stripe Terminal payments at a later time.

### Reader Configuration and Management

*   **Terminal Configurations:** Applying various configurations to your readers at the account or location level.
*   **Admin Menu Passcode:** Securing the admin menu on smart readers.
*   **Splash Screen:** Customizing the default screen displayed on readers.
*   **Offline Mode:** Configuring whether readers can operate in offline mode.
*   **Reboot Time Window:** Customizing when readers reboot to avoid service interruptions.
*   **Tipping:** Configuring on-reader tipping options.
*   **WiFi and Cellular Network Configuration:** Remotely configuring network settings for smart readers.

### Advanced Features and Integrations

*   **Apps on Devices:** Deploying and managing your point-of-sale (POS) applications on Stripe smart readers.
    *   Build and test your app.
    *   Prepare for app review.
    *   Submit your app.
    *   Deploy your app (in Dashboard or via API).
    *   Monitor your deployment.
    *   Troubleshoot app-related issues.
*   **Display Cart Details:** Dynamically updating cart details on the reader screen.
*   **Collect Data:**
    *   Collecting swiped data (e.g., for gift cards).
    *   Collecting on-screen inputs for various use cases.
    *   Collecting tapped data for NFC instruments.
*   **Collect Tips:** Understanding different methods for collecting tips (on-receipt and on-reader).
*   **Provide Receipts:** Offering compliant physical or email receipts to customers.
*   **Refund Transactions:** Processing cancellations or refunds for Stripe Terminal payments.
*   **Use Terminal with Connect:** Integrating Stripe Terminal with your Connect platform for multiparty payments.

### SDKs and API References

*   **JavaScript API Reference:** Documentation for the Stripe Terminal JavaScript SDK.
*   **Mobile Readers:** Information on using mobile readers with iOS, Android, and React Native SDKs.
*   **Smart Readers:** Details on integrating with smart readers.
*   **SDK Migration Guides:** Guides for migrating between different versions of the Stripe Terminal SDKs.

### Testing and Troubleshooting

*   **Test Stripe Terminal:** Strategies and tools for effectively testing your Terminal integration, including reader simulators and test cards.
*   **Network Requirements:** Ensuring your network is configured correctly for Stripe Terminal.
*   **Troubleshooting Guides:** Specific troubleshooting steps for various readers (M425, P630, UX700, V660p) and general app-related issues.