Skip to main content

Finalize Legal Person Onboarding

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

Triggers validation and finalization of legal person onboarding.

  • Legal person onboarding exists and is in PENDING status

  • Shareholders created for the legal person flow via POST /users/shareholders

  • Legal person documents uploaded: social_contract + (balance_sheet OR revenue_statement)

  • At least one active legal representative is registered

  • Each legal representative is linked to a shareholder (via shareholder_id)

  • Legal representative documents uploaded for all active representatives: selfie, identity_document family, qualification_declaration

  • Successful synchronous response is IN_PROCESS

  • Terminal onboarding result is asynchronous

  • On 422, handle the returned business code. Common cases: ONBOARDING_INVALID_STATUS, SHAREHOLDERS_REQUIRED, ONBOARDING_DOCUMENTS_MISSING, LEGAL_REPRESENTATIVE_DOCUMENTS_MISSING, SHAREHOLDER_MISSING_LEGAL_REPRESENTATIVES

Request​

Path Parameters

    id stringrequired

    Legal person 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

    UUID (v4) of the product that the request should use. Send it explicitly when the authenticated user has more than one product or when the integration must select a specific product. If omitted and the endpoint does not require it, the API uses the authenticated user's default product.

    x-product-target-user-uuid string

    UUID (v4) of the user on whose behalf the request should run within the selected product. If omitted, the request runs as the authenticated user. Requires x-product-uuid.

Responses​

Legal person onboarding submitted for review. Status is IN_PROCESS after successful validation.

Schema
    id stringrequired

    Legal person 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...