Sign in
An image of the Stripe logo
Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
No-code
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
Online payments
Products and prices
Invoicing
Subscriptions
Quotes
In-person payments
Multiparty payments
    Overview
    Get started
    Collect payments then pay out
    Enable other businesses to accept payments directly
    Pay out money
    Explore Connect
    Onboard your accounts
    Choose your account type
    Standard
    Express
    Custom
      Onboard accounts
      Update accounts
      Handle verification
      Handle verification with the API
      Required info
      Future requirements
    Service agreement types
    Payment methods
    Account capabilities
    Additional verifications
    Update verified info
    Connect embedded UIs
    Quickstart
    Get started with Connect embedded UIs
    Accept payments
    Create a charge
    Create a payments page
    Create payment links with Connect
    Connect integration guide
    Automatic payment methods
    Set statement descriptors
    Connect platforms using the Payment Methods API
    Create subscriptions
    Create invoices
    Debit Express and Custom connected accounts
    Pay out
    Set bank and debit card payouts
    Bank accounts
    Manage payout schedule
    Manual payouts
    Payout reversals
    Instant Payouts
    Cross-border payouts
    Crypto payouts
    Manage funds
    Add money to your platform balance
    Account balance
    Handle multiple currencies
    Manage accounts
    Best practices
    Listen for updates
    Dashboard account management
    Understanding risk offerings
    Platform controls for Standard accounts
    Make API calls for connected accounts
    Set MCCs
    Testing
    Manage tax forms
    Overview
    Get started with tax reporting
    1099 Tax Support and Communication Guide
    Tax form settings
    Calculation methods
    File tax forms
    File tax forms with states
    Identify forms with missing information
    Update tax forms
    Deliver tax forms
    E-delivery for 1099 tax forms
    Correct tax forms
    Split tax forms
    Tax year changeover
    What's new for tax year 2022
After the payment
Add payment methods
Payment Links
Stripe Checkout
Stripe Elements
About the APIs
Regulation support
Implementation guides
Testing
Connect
·
HomePaymentsMultiparty paymentsCustom

Updating accounts and services agreement acceptance

Learn how to update the Connect accounts you manage through the API and how to best handle acceptance of the Stripe Connected Account Agreement.

Account types

Connect platforms can work with three different account types.

The content on this page applies only to Express and Custom accounts.

Working with Express and Custom accounts provides platforms with a lot of power: almost every Stripe account property is available through the API.

Platforms need to update connected Express and Custom accounts to:

  • Handle acceptance and re-acceptance of the Stripe Connected Account Agreement (by Custom accounts)
  • Handle identity verification (of Custom accounts)
  • Manage the connected business’s information, such as the name, logo, and URL
  • Set some charge behaviors
  • Establish payout handling

All the above can be done through an update account call, demonstrated in the next code example, although identity verification and payouts are more complex.

Command Line
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
\ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "metadata[internal_id]"=42

Viewing an account’s Dashboard

You, as the platform, can update some account settings without using the API by viewing the Connected accounts section of your Dashboard.

Click any connected account in the list to see more details about that account

This allows you—or your support team—to see the status of payouts, search for payments, and update some of the connected account’s information if needed. The information that you can view and change depends on the type of connected account.

Stripe Services Agreement acceptance

Stripe requires that all Custom accounts accept their service agreements. The service agreement your users must accept depends on which service agreement type their accounts are under. You can change the type of service agreement up until the time they accept it. It’s your responsibility to make sure your users agree to the correct service agreement before accepting or receiving payments through Stripe on your platform.

Your users must consent once again to the Stripe Services Agreement (SSA) if they update their tax identification number. If you allow an account to change its verified tax identification number, then you must make sure that the account agrees once again to the Stripe Services Agreement (SSA) by following these instructions, to verify that it accepts transfer of ownership of their account and its balances from the entity assigned the initial Tax ID to the one assigned the new Tax ID.

Referencing the agreement

As a minimum requirement, you must present your users with a link to the correct agreement and they must expressly consent to it prior to using Stripe (for example, at the point of activating their account).

Register Your Account

By registering your account, you agree to our Services Agreement and the Stripe Connected Account Agreement.

Adding Stripe to your services agreement

We also suggest you add a section to your services agreement making it clear that your users’ acceptance of payments is provided subject to their connected account agreement. One way to achieve this is by including a clear reference and link to the connected accounted agreement.

Payment processing services for [account holder term, for example, drivers or sellers] on [platform name] are provided by Stripe and are subject to the Stripe Connected Account Agreement, which includes the Stripe Terms of Service (collectively, the “Stripe Services Agreement”). By agreeing to [this agreement / these terms / and so on] or continuing to operate as a [account holder term] on [platform name], you agree to be bound by the Stripe Services Agreement, as the same may be modified by Stripe from time to time. As a condition of [platform name] enabling payment processing services through Stripe, you agree to provide [platform name] accurate and complete information about you and your business, and you authorize [platform name] to share it and transaction information related to your use of the payment processing services provided by Stripe.

Indicating acceptance Custom accounts

To indicate to Stripe that a connected account accepted the Stripe Connected Account Agreement, perform an update account call, providing the acceptance date (as a timestamp) and user’s IP address:

Command Line
curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
\ -u
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \ -d "tos_acceptance[date]"=1609798905 \ -d "tos_acceptance[ip]"="8.8.8.8"

See also

  • Identity Verification
  • Account Tokens
  • Controlling Bank and Debit Card Payouts
  • Full API reference
Was this page helpful?
Questions? Contact us.
Watch our developer tutorials.
Check out our product changelog.
Powered by Markdoc
You can unsubscribe at any time. Read our privacy policy.
On this page
Viewing an account’s Dashboard
Stripe Services Agreement acceptance
See also
Stripe Shell
Test mode
Welcome to the Stripe Shell! Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to your Stripe account and press Control + Backtick on your keyboard to start managing your Stripe resources in test mode. - View supported Stripe commands: - Find webhook events: - Listen for webhook events: - Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$