Skip to main content

Finalize Legal Person Onboarding (Step 5 - Final)

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

Step 5: Finalize the onboarding process.\n\nTriggers the validation and finalization of the legal person onboarding. The system will check if all requirements are met before changing the status to IN_PROCESS.\n\nValidation Checklist:\n- [ ] Legal Person Onboarding exists and is in PENDING status\n- [ ] Company Documents Uploaded: SOCIAL_CONTRACT + (BALANCE_SHEET OR REVENUE_STATEMENT)\n- [ ] At least one Legal Representative is registered\n- [ ] Legal Representative Documents Uploaded (for ALL reps): selfie, identity_document, qualification_declaration\n\nOutcome:\n- Success: Status changes to IN_PROCESS. The compliance team will review the application.\n- Failure: Returns 422 Unprocessable Entity with details about missing documents or requirements.

Request​

Path Parameters

    id stringrequired

    Onboarding ID to finalize.

Header Parameters

    x-transaction-uuid stringrequired

    The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.

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