Set Up Integrations for Mobile Number Authentication with One-Time Password (OTP)
Set up integrations to confirm that the applicant’s phone number is active and under their control by sending a one-time password (OTP).
Required Editions
| Available in: Lightning Experience |
| Available in: Professional, Enterprise, and Unlimited Editions |
| User Permissions Needed | |
|---|---|
| To create integration definitions: | IndustriesIntegrationFwk |
| To create or update an Integration Procedure, a Data Mapper, or an Omniscript: | OmniStudio Admin AND Digital Lending India Admin User |
- From Setup, in the Quick Find box, enterintegration definitions, and then select Integration Definitions.
-
To send the mobile OTP to the phone, create an integration definition.
- Click + New.
- Select External Services Defined as the type.
- Enter DigitalLendingIndiaMobileOTPIntegDef as the integration definition name.
- For external service, enter the name of the registered external service that you want to use to connect to an external API.
- For action, select the method or the operation of the service provider API to be called to get an OTP for Aadhaar authentication.
- Select DigitalLendingIndiaMobileOTPRequest as the input processor.
- Turn on Integration Ochestrator.
-
Select IntegrationOrchestrationShowIntegTimelineDetails as the
Flexcard.
Make sure to select a cloned and activated version of the Flexcard. This Flexcard shows the integration execution status and the request and response details.
- Select Manual as the integration execution mode.
This integration definition is invoked by the DigitalLendingIndiaSendMobileOTP integration procedure from the DigitalLendingIndiaApplicationFormOnboarding and DigitalLendingIndiaAdditionalApplicantOnboarding Omniscripts. It is triggered when a user clicks the Verify Mobile button on the Omniscript.
The DigitalLendingIndiaSendMobileOTP integration procedure calls the DigitalLendingIndiaTransformMobileOTPPayload data mapper.
The DigitalLendingIndiaMobileOTPRequest input processor calls these data mappers.- DigitalLendingIndiaGetInitiatedPartyIdentity
- DigitalLendingIndiaCreatePartyIdentityVerf
- DigitalLendingIndiaTransformMobileOTPRequest
To prepare the input in a format as expected by the external service API for sending the mobile OTP, configure the cloned copy of the DigitalLendingIndiaTransformMobileOTPRequest data mapper.
- Save your changes and activate the integration definition.
-
To get the OTP sent to the mobile phone, create another integration definition.
- Select External Services Defined as the type.
- Enter DigitalLendingIndiaMobileStatusIntegDef as the integration definition name.
- For the external service, enter the name of the registered external service that you want to use to connect to an external API.
- For the action, select the method or the operation of the service provider API to be called to match the party profile address against the address in Aadhaar.
- Select DigitalLendingIndiaMobileStatusRequest as the input processor.
- Select DigitalLendingIndiaMobileStatusResponse as the output processor.
This integration definition is invoked by the DigitalLendingIndia_VerifyMobileOTPStatus integration procedure from the DigitalLendingIndiaApplicationFormOnboarding and DigitalLendingIndiaAdditionalApplicantOnboarding Omniscripts. It is triggered when a user clicks the Verify Mobile button on the Omniscript.
The DigitalLendingIndia_VerifyMobileOTPStatus integration procedure calls the DigitalLendingIndiaTransformMobileOTPStatusPayload data mapper.
The DigitalLendingIndiaMobileStatusRequest input processor calls the DigitalLendingIndiaTransformMobileStatusRequest data mapper.
To prepare the input in a format as expected by the external service API to get the mobile OTP sent to the mobile phone, configure the cloned copy of the DigitalLendingIndiaTransformMobileStatusRequest data mapper.
-
To validate the OTP entered by the user, create another integration definition.
- Select External Services Defined as the type.
- Enter DigitalLendingIndiaMobileDetailIntegDef as the integration definition name.
- For external service, enter the name of the registered external service that you want to use to connect to an external API.
- For action, select the method or the operation of the service provider API to be called to get an OTP for Aadhaar authentication.
- Select DigitalLendingIndiaMobileDetailsRequest as the input processor.
This integration definition is invoked by the DigitalLendingIndia_GetPersonalDetailsFromMobileNumber integration procedure from the DigitalLendingIndiaApplicationFormOnboarding and DigitalLendingIndiaAdditionalApplicantOnboarding Omniscripts. It is triggered when a user clicks the Get Details button on the Omniscript.
The DigitalLendingIndia_GetPersonalDetailsFromMobileNumber integration procedure calls the DigitalLendingIndiaGetPersDetailsFromMobNbrPayload data mapper.
The DigitalLendingIndiaMobileDetailsRequest input processor calls the DigitalLendingIndiaTransformMobileDetailsRequest data mapper.
To prepare the input in a format as expected by the external service API for validating the mobile OTP, configure the cloned copy of the DigitalLendingIndiaTransformMobileDetailsRequest data mapper.
- Save your changes and activate the integration definition.
