Phone number NCT

Use this guide to build your NCT workflows

Pre-requisites to initiate phone number NCT

• Ensure the investor is onboarded and the mf_investment_account is present
• For whichever folio the investors wants to initiate an NCT, ensure that folio is tagged to the mf_investment_account. You can use Fetch all Folios API to check this

Phone number NCT workflow

1. Create a non_commercial_transaction object with type = update_phone_number and other mandatory attributes as mentioned in the Create Phone Number NCT API. The status would be consent_required at this stage
2. The investor will receive an OTP on the existing phone number on the folio from the gateway
3. Use Update Phone Number NCT API to provide the OTP that the investor received. Now the status would be changed to second_consent_required provided the OTP was successfully validated. If this OTP was not given in the valid time range, the status would be marked as expired
4. Use Update Phone Number NCT API again to provide the second OTP that the investor received on the new phone number that has to be updated on the folio. Now the status would be changed to submitted provided the second OTP was also successfully validated. If this OTP was not given in the valid time range, the status would be marked as expired
5. Now the Phone Number NCT request would have been submitted to the gateway. Use Fetch Non-Commercial Transaction API using the non_commercial_transaction ID to get the updated status of this NCT request. The final status can either be successful or failed

Why do I need to provide two consents?

The first consent that the investor provides, would be collected on the phone number that is currently existing on the folio. However, since this is an update_phone_number NCT, the system also has to ensure the new phone number is also valid and hence a second consent would be requested on that new phone number that would get updated on the folio.

Testing

To test the various scenarios in your application during the development process, use the following simulation logic in the sandbox environment.