Loading

DFS OTP Services API (latest)

Download OpenAPI specification:

Contains functionality around OTP (one time password) services.

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

ContactVerification

Check validity of a one-time verification code

Checks validity of a one-time verification code sent to the contact under the context of a specific session.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

Contact id

sessionId
required
string

Session id

key
required
string

Key

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "keyStatus": "Valid",
  • "attemptsLeft": 0
}

Verify a one-time verification code

Verifies a one-time verification code sent to the contact under the context of a specific session.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

Contact id

sessionId
required
string

Session id

key
required
string

Key

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "keyStatus": "Valid",
  • "attemptsLeft": 0
}

Send a one-time verification code

Sends a one-time verification code to the contact in a specific channel. If a sessionId is not specified, a generated sessionId would be returned (to be used when verifying the key).

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

Contact ID.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Send verification key request.

sessionId
string or null
channel
string (VerificationChannelKey)
Enum: "Sms" "Email"
templateMetadataKey
string or null

Responses

Request samples

Content type
{
  • "sessionId": "string",
  • "channel": "Sms",
  • "templateMetadataKey": "string"
}

Response samples

Content type
application/json
{
  • "generatedSessionId": "string"
}

Send a one time verification code to a pending communication channel

Sends a one time verification code to a pending communication channel as set in contact details. This endpoint should only be used internally when orchestrating communication channel update using OTP.

Authorizations:
Bearer
path Parameters
contactId
required
integer <int32>

Contact ID.

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Send verification key request.

sessionId
string or null
channel
string (Api.ContactVerifications.SendVerificationKeyPendingCommunicationChannels.VerificationChannelKey)
Enum: "Sms" "Email"

Responses

Request samples

Content type
{
  • "sessionId": "string",
  • "channel": "Sms"
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}