Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer tools
Overview
About Stripe payments
Upgrade your integration
Payments analytics
Online payments
OverviewFind your use caseManaged Payments
Use Payment Links
Build a checkout page
Build an advanced integration
Build an in-app integration
Payment Methods
Add payment methods
Manage payment methods
Faster checkout with Link
Payment interfaces
Payment Links
Checkout
Web Elements
In-app Elements
Payment scenarios
Custom payment flows
Flexible acquiring
Orchestration
In-person payments
Terminal
    Overview
    Accept in-person payments
    Integration design
    Select your reader
    Design an integration
      Design a multiparty platform
        Multi-party payments with Connect
    Quickstart
    Example applications
    Testing
    Terminal setup
    Set up your integration
    Connect to a reader
    Accepting a payment
    Collect card payments
    Additional payment methods
    Accept offline payments
    Mail order and telephone order payments
    Regional considerations
    During checkout
    Collect tips
    Collect and save payment details for future use
    Flexible authorisations
    After checkout
    Refund transactions
    Provide receipts
    Customize checkout
    Cart display
    Collect on-screen inputs
    Collect swiped data
    Collect tapped data for NFC instruments
    Apps on devices
    Manage readers
    Order, return, replace readers
    Register readers
    Manage locations and zones
    Configure readers
    Monitor Readers
    Encryption
    References
    API references
    Mobile readers
    Smart readers
    SDK migration guide
    Deployment checklist
    Stripe Terminal reader product sheets
Other Stripe products
Financial Connections
Crypto
Climate
HomePaymentsTerminalDesign an integration

Design a multiparty platform

Design a Terminal integration with your business serving as a central platform.

Copy page

Stripe Terminal is fully compatible with Stripe Connect, enabling your platform or marketplace to accept in-person payments. If you aren’t familiar with Stripe Connect, we recommend going through the Connect overview.

There are two options for integrating Terminal with Connect, depending on the account type you choose for your platform’s connected accounts. To decide which option best suits your business’s needs, refer to the following table:

Custom or ExpressStandard
Who owns the API resources?PlatformConnected accounts
Who has access to the Terminal hardware ordering dashboard and APIs?PlatformConnected accounts
Which charge types can I use?
  • Destination charges
  • Separate charges/transfers
  • Direct charges

Express or Custom Connect

In a Connect integration with Express or Custom accounts, all API resources belong to the platform account. As needed, you can associate Terminal objects like Readers and Locations with a particular connected account by including them in the metadata object on these resources.

When processing payments, you specify the connected account as the destination for the funds using the on_behalf_of, transfer_data[destination], and application_fee_amount parameters. This creates a transfer to the connected account automatically and establishes the connected account as the merchant of record.

Standard Connect

In a Connect integration with Standard accounts, all API resources belong to individual connected accounts. When making API requests such as for creating locations, readers, and payments, you pass the connected account ID in the Stripe-Account header. This tells Stripe that the request is effectively being made by the connected account.

When processing payments, you also pass the connected account’s ID in the Stripe-Account header, which creates the charge directly on the connected account.

Next steps

  • Build a sample integration
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access programme.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc