Sign in
An image of the Stripe logo
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
Future requirements
Service agreement types
Account capabilities
Additional verifications
Update verified info
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 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 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
Update tax forms
Deliver tax forms
Correct tax forms
Split tax forms
Tax year changeover
Testing
No-code options
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.

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:

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.
View developer tutorials on YouTube.
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
Stripe Shell
Test mode
▗▄ ▄▟█ █▀▀ ▗▟████▙▖ ██████ ███▗▟█ ███ ███▗▟██▙▖ ▗▟█████▙▖ ███▖ ▀▀ ███ ███▀▀▀ ███ ███▀ ███ ███ ███ ▝▜████▙▖ ███ ███ ███ ███ ███ █████████ ▄▄ ▝███ ███ ▄ ███ ███ ███▄ ███ ███ ▄▄ ▝▜████▛▘ ▝▜███▛ ███ ███ ███▝▜██▛▘ ▝▜█████▛▘ ███ ▀▘
Welcome to the Stripe Shell! This is a graphical user interface of the Stripe CLI. You can use it to discover webhook events and manage your Stripe resources. By pressing ctrl + ` you can toggle it open from any page within the Stripe documentation. - View supported commands: - Listen for webhook events: - Trigger webhook events: - Call Stripe APIs: stripe [api resource] [api operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$