Updating accounts and services agreement acceptance

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.

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).

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.

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"