feature

One-time password (OTP)

Learn how to send an OTP and how to validate it. This can be added into an acquisitions journey at any step before requestDecision.

ApplicationOtpInitiate

Send a One-time Passcode (OTP) to the application mobile phone number.

post

/v2/applications/{id}/kycauthentications/otp

See API reference

state

•

string enum

Enum values

initiated

Code Request Successful.

authenticated

OTP Session is Authenticated.

ApplicationOtpValidate

Verify the code provided by the applicant to the code sent to the phone number.

Request Example

Request

1curl --request POST \
2  --url https://dapi.stg-newdaytechnology.net/acquisition/v2/applications/%7Bid%7D/kycauthentications/otp \
3  --header 'Merchant-Id: SOME_STRING_VALUE' \
4  --header 'Session-Id: SOME_STRING_VALUE' \
5  --header 'content-type: application/json' \
6  --data '{"mobileNumber":"stringstrin","homeNumber":"string","email":"strings","transactionDetails":{"merchantName":"string","transactionValue":0.1,"transactionCurrency":"string"},"journeyId":"string"}'

Response Example

Response

JSON

1{
2  "state": "initiated",
3  "authId": "25d4321e-f980-49d3-983b-4275c49dc2c4",
4  "journeyId": "string",
5  "remainingPasscodes": 0,
6  "additionalInfo": {
7    "property1": {},
8    "property2": {}
9  }
10}