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- [ ] Shareholders created (equity structure) via POST /shareholders\n- [ ] Company Documents Uploaded: SOCIAL_CONTRACT + (BALANCE_SHEET OR REVENUE_STATEMENT)\n- [ ] At least one Legal Representative is registered\n- [ ] All Legal Representatives are linked to a shareholder (via shareholder_id)\n- [ ] Legal Representative Documents Uploaded (for ALL reps): selfie, identity_document, qualification_declaration\n\nImportant Notes:\n- All legal representatives (natural persons) must be linked to a shareholder (natural person or legal person) from the equity structure\n- If a shareholder is a PJ, it must have at least one legal representative (PF) linked to it\n- The CEP (zip code) of the company will be sent to CAF for validation\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

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