Create account
Sign in
Home
Payments
Business operations
Financial services
Developer tools
Security
All products
Home
Payments
Business operations
Home
Payments
Business operations
Financial services
Developer tools
Support
Overview
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
Service agreement types
Account capabilities
Update verified info
Accept payments
Create a charge
Create a payments page
Add payment methods
Set statement descriptors
Clone customers across accounts
Create a subscription
Debit connected accounts
Pay out
Set bank and debit card payouts
Bank accounts
Manage payout schedule
Manual payouts
Payout reversals
Instant Payouts
Cross-border payouts
Manage funds
Add money to your platform balance
Account balance
Handle other currencies
Manage accounts
Best practices
Listen for updates
Dashboard account management
Platform controls for Standard accounts
Make API calls for connected accounts
Set MCCs
Testing
Manage tax forms
Overview
Get started with tax reporting
Tax form settings
Calculation methods
File tax forms
File tax forms with states
Modify tax forms
Deliver tax forms
Tax reporting for Payable users
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.

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

Viewing an account’s Dashboard

Platforms can update some account settings without using the API by viewing the connected account’s Stripe Dashboard:

  1. Go to the Connected accounts section of your Dashboard.
  2. Click the ID of the connected account to use to see more details about that account.
  3. On the resulting page, click View dashboard as.

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.

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 (e.g., 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, e.g. 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 / etc.] 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

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:

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

Next steps

  • Identity Verification
  • Account Tokens
  • Controlling Bank and Debit Card Payouts
  • Full API Reference
Was this page helpful?
Questions? Contact us.
Developer tutorials on YouTube.
You can unsubscribe at any time. Read our privacy policy.
On this page
Viewing an account’s Dashboard
Stripe Services Agreement acceptance