Change the account representative for connected accounts with platform-gathered verification requirements

An account must always have a current, verified Person who serves as the primary representative for the account, indicated by the relationship[representative] field. Verified account representative information cannot be updated. However, platforms may unset the current representative to update information or change the account representative for connected accounts with platform-owned verification through the API by doing the following:

  1. Ensure the Person currently marked as representative has verification.status = verified. Representatives must be verified before they can be changed.
  2. Use the Persons API to set relationship.representative = false on this person. This will trigger a 7-day grace period and will add relationship.representative back to the requirements hash with a 7-day deadline.
  3. Add a new person, or update an existing one and set relationship.representative = true.
  4. Ensure that the new person is verified successfully by checking the verification.status.

Stripe recommends verifying the Person prior to setting them as the account representative. If you are not able to verify the Person prior to marking them as the new representative, you will need to manage the verification process within the 7-day grace period described above.

Restrictions

  • Charges and payouts may be blocked after the 7 day grace period (additional updates will not trigger an extension if the relationship.representative is not verified)
    • Read more about this here.
  • This is not possible if the business_type=individual. If changes are required for verified individual accounts, contact Stripe Support.

Did this answer your question?