Intergiro developer portal

# Onboarding

To embed the onboarding process to allow onboarding of your new customers with your mobile application you need to integrate with:

# Request onboarding token

REQUIREMENT

return_url is a mandatory parameter and must be a deep link. This URL is required for the proper completion of the onboarding flow. The application providing the return_url must implement support for handling this deep link.

Token for initiating the onboarding process can be requested via the POST /individuals/:id/onboard endpoint:

 




 


POST /v3/individuals/a015e4cd-543c-4c26-b820-72ac7b9710d1/onboard
Content-Type: application/json
Authorization: Bearer <access_token>

{
  "return_url": "your-app-scheme://onboarding/callback"
}

The response should look like as following:

 



 


HTTP 200 OK
{
  "redirect_url": "https://3d.staging.intergiro.tech/...",
  "expires_at": "2025-06-25T12:00:33+02:00",
  "token": "eyJjbGFpbXMiOnt9LCJwZXJtaX"
}

Use the token to call our the launch method of the Mobile SDK (Android SDK or iOS SDK), so that it opens a UI provided by Intergiro where your new customer can go through the onboarding flow.

← SCA →