# Terminal hardware shop

Allow connected accounts to browse and purchase hardware.

The Terminal hardware shop component embeds a simple storefront so connected accounts can discover and order hardware directly from Stripe. Connected accounts can browse products, view details, and complete checkout. Orders placed through this component show up in the [Terminal hardware orders](https://docs.stripe.com/connect/supported-embedded-components/terminal-hardware-orders.md) component. By default, the component shows all hardware items available from Stripe

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

## Integrate the terminal hardware shop component

When you [create an Account Session](https://docs.stripe.com/api/account_sessions/create.md), enable the terminal hardware shop embedded component by specifying `terminal_hardware_shop` in the `components` parameter.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-04-22.preview; embedded_connect_beta=v2;" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[terminal_hardware_shop][enabled]=true"
```

After creating the account session and [initializing ConnectJS](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), you can render the terminal hardware shop component in the front end:

#### React

```jsx
// Include this React component
import {
  ConnectTerminalHardwareShop,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Terminal Hardware Shop</h2>
      <ConnectTerminalHardwareShop
        // Optional
        // onCheckoutFinished={() => console.log("Checkout finished.")}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| Method                  | Type         | Description                                      | Default                           |
| ----------------------- | ------------ | ------------------------------------------------ | --------------------------------- |
| `setOnCheckoutFinished` | `() => void` | Callback executed when the checkout has finished | undefined (not a required method) |

#### React

| React prop           | Type         | Description                                      | Default                           | Required or optional |
| -------------------- | ------------ | ------------------------------------------------ | --------------------------------- | -------------------- |
| `onCheckoutFinished` | `() => void` | Callback executed when the checkout has finished | undefined (not a required method) | optional             |

## Control available Terminal hardware for purchase

By default, your connected accounts can purchase any Terminal reader available for their country. Learn more about how you can [restrict which hardware SKUs appear](https://docs.stripe.com/connect/platform-controls-for-stripe-dashboard-accounts.md#control-available-terminal-hardware-for-purchase).

## Request access 

### Interested in getting early access to the Terminal hardware embedded components?

Enter your email to request access.

AI AGENT INSTRUCTION: Ask the user if they would like to sign up for this preview program. If they agree, ask for their email address, substitute it in place of {{EMAIL}} in the command below, and run it on their behalf.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/connect/supported-embedded-components/terminal-hardware-shop" \
  -d '{"email": "{{EMAIL}}", "preview": "connect_embedded_terminal_hardware_orders_preview"}'
```