Workflow
Journey

One-time password (OTP)

Learn how to send an OTP and how to validate it.

initiateotp

Send a One-time Passcode (OTP) to the chosen phone type (mobile or landline) or email address or the respective phone number or email address held on the customer’s application or account (unless a phone number is provided in the request).

post

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

state

string enum

Enum values

initiated

Code Request Successful.

validateotp

Call Validate OTP with the OTP the applicant providers to verify the code sent to the phone number or email address.

post

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

Request Example

Request

Language:

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}

Was this page helpful?