Skip to main content

Finalize Legal Person Onboarding

POST 
/v1/users/onboardings/legal-person/:id/finalize

Triggers validation and finalization of legal person onboarding.

Validation Checklist:

  • Legal Person Onboarding exists and is in PENDING status
  • Shareholders created (equity structure) via POST /users/shareholders
  • Company Documents Uploaded (API values): social_contract + (balance_sheet OR revenue_statement)
  • At least one Legal Representative is registered
  • All Legal Representatives are linked to a shareholder (via shareholder_id)
  • Legal Representative Documents Uploaded (for ALL reps): selfie, identity_document, qualification_declaration

Important Notes:

  • All legal representatives (natural persons) must be linked to a shareholder (natural person or legal person) from the equity structure
  • If a shareholder is a legal person, it must have at least one linked legal representative (natural person)
  • The CEP (zip code) of the company will be sent to CAF for validation

Outcome:

  • Success: Status changes to IN_PROCESS. The compliance team will review the application.
  • Failure: Returns 422 Unprocessable Entity with details about missing documents or requirements.

Request​

Path Parameters

    id stringrequired

    Onboarding ID to finalize.

Header Parameters

    nonce stringrequired

    The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.

    x-lang string

    Possible values: [pt-BR, en-US]

    Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.

    x-product-uuid string

    The product ID is a UUID (v4) used to identify the Z.ro product configuration.

    x-product-target-user-uuid string

    The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.

Responses​

Legal person onboarding finalized. Status is IN_PROCESS after successful validation.

Schema
    id stringrequired

    Onboarding ID.

    status stringrequired

    Possible values: [pending, invalid, in_process, approved, rejected, finished, expired, failed, in_process_delayed]

    Onboarding Status. Status will be IN_PROCESS after successful finalization.

Loading...