Verify OTP

Verify OTP

The Verify OTP API is used to check and grant access to sensitive information, this will only be granted if the user provides a valid one time password token.

Input Parameters:

Name	Required	Definition	Comments
Token	Y	Format: Number, 6 Description: Six digits value (should be unique for a period of N minutes (where N is a system parameter)

Output Parameters:

Name	Definition	Failure Case	Success Case	Comments
RequestedResult	Format: String, 50 Description: Closed list of values, the following values are allowed CardNumber, ProcessorAccountNumber	Not returned	Returned
RequestedValue	Format: String, 50 Description: Value content depends on the RequestedResult value that was used with this Values can be of type (currently): CardNumber or ProcessorAccountNumber	Not returned	Returned

XML Samples

Input XML

<?xml version="1.0"?>
<PraxellXMLRequest>
  <AuthenticationDetails>
    <SessionID>1234567890</SessionID>
    <ClientSourceIP></ClientSourceIP> 
 </AuthenticationDetails>
 <ServiceDetails>
    <UniqueRequestId>963369551</UniqueRequestId>
    <ServiceName>VerifyOTP</ServiceName>
  </ServiceDetails>
  <Origin>
    <OriginType>ExtAPI</OriginType>
  </Origin>
  <ServiceParams>
    <Token>123456</Token>
  </ServiceParams>
</PraxellXMLRequest>

<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>VerifyOTP</ServiceName>
        <SessionId>38097317201110064</SessionId>
        <StatusCode>0</StatusCode>
        <StatusName>StatusOK</StatusName>
        <StatusDescription>NA</StatusDescription>
        <ServiceDate>2011-06-05 17:10:40</ServiceDate>
        <ServiceId>38097317201110064</ServiceId>
    </ResponseDetails>
<ResponseParams>
    <RequestedResult>CardNumber</RequestedResult>
    <RequestedValue>1234567890123456</RequestedValue>
</ResponseParams>
</PraxellXMLResponse>

<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>VerifyOTP</ServiceName>
    <SessionId>07071612200737105</SessionId>
    <StatusCode>70029</StatusCode>
    <StatusName>Data not found (cardholder not found)</StatusName>
    <StatusDescription>Data not found (cardholder not found)</StatusDescription>
    <ServiceDate>2021-10-01 12:37:50</ServiceDate>
    <ServiceId>07071612200737105</ServiceId>
  </ResponseDetails>
  <ResponseParams>
  </ResponseParams>
</PraxellXMLResponse>