Onboarding Individuals with our Onfido Integration

If you are a looking to onboard individual customers through Modulr, and Modulr are completing the customer due diligence on your clients on your behalf, you can use our Onfido Instant ID Verification integration journey.
In order for you to integrate with this journey, you simply have to connect to one endpoint and one webhook.

Create new Individual application endpoint

To use this Onfido Integration, you only need to use one endpoint – POST /provision-onboarding-customer. This endpoint collects basic details on your client, including the following information:

• A Journey Type – this should be set as ‘INDIVIDUAL’
• Your client’s name
• Your client’s email address
• An expected monthly spend - if you don't know this you will still need to enter an estimated value
• External Reference - should be something that can be used to identify the individual who is applying, this way you will be able to map back any CUSTVSTAT webhook notifications back to the correct applying client.

Example Request

{ "journeyType": "INDIVIDUAL", "applicantEmail": "[email protected]", "preCapturedInfo": { "name": "Test Example", "expectedMonthlySpend": 0, "type": "INDIVIDUAL", "externalReference": "test example ref" "tcsVersion": 1 } }

Example Response

{ "continuationUrl": "[https://modulr.eu.onfido.app/example]", "applicationId": "J123456789" }

Once you submit a /provision-onboarding-customer request, you will receive an application ID & an Onfido Smart Capture link, which can be sent to your client so they can access the Onfido portal for your client to begin completing their application.

Once your client has completed their application, we will create them as a customer in our platform and complete all remaining customer due diligence.

CUSTVSTAT webhook

Once your client has completed their application and passed any remaining customer due diligence checks, you will receive a notification form our Customer Verification Status webhook that will provide you with any changes in verification status & will come with an external reference.

The external reference should be used to identify your clients, so that you can match the new onboarded client to the application ID you first received when making your /provision-onboarding-customer request