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.

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:

Go to the Connected accounts section of your Dashboard.
Click the ID of the connected account to use to see more details about that account.
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).

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: