Step 6: Finalise onboarding submission

Once all required data, associates, and documents have been submitted, you must finalise the onboarding request.

POST
/corporates/finalise-submission

This endpoint formally submits the onboarding application for compliance review.

What you need before calling this endpoint

You must provide:

externalReference
The unique identifier returned when the corporate profile was created

Before finalising, ensure:

All mandatory corporate fields are completed

All required associates are added

Ownership thresholds (e.g., ≥25%) are satisfied

Parent Entities (if applicable) are declared

All required documents are uploaded

What this step does

When successfully called:

The onboarding status transitions from PENDING to UNDER REVIEW

The application is submitted to Compliance

No further edits should be made unless additional information is requested

Compliance review is asynchronous.

Validation behaviour

If any required element is missing at the time of submission:

The request will fail

The onboarding status will remain unchanged

A structured error response will indicate exactly what is missing
Typical validation errors may include:

Missing mandatory associates

Incomplete ownership structure

Missing required documents

Invalid or incomplete compliance declarations

Submission will only proceed once all required components are complete.

What happens after submission

COMPLIANCE REVIEW

The application is with Sokin and is under review.

APPROVED

Compliance approval has been granted

Account provisioning begins

The corporate client will soon be enabled to transact

REJECTED

The application has been declined based on compliance policy.
Further action may require re-onboarding.

MODEL_SWITCHED

The due diligence model has been updated due to eligibility changes (e.g., ownership or residency conditions).
Additional data or documents may now be required before approval.

Important

Finalising the onboarding request is the last step in the onboarding workflow.

Approval is not immediate.

All integrations should rely on webhook notifications rather than polling for status changes.

Step 6: Finalise onboarding submission

What you need before calling this endpoint#

What this step does#

Validation behaviour#

What happens after submission#

COMPLIANCE REVIEW#

APPROVED#

REJECTED#

MODEL_SWITCHED#

Important#