Request OTP

Request OTP

The Request OTP API is used to request access to sensitive information, this will trigger a one time token password generation process. The user will need to provide this value on a subsequent call to the Verify OTP API NOTE: This API will send a text message (SMS) to the current user.

Input Parameters:

Name
Required
Definition
Comments

Purpose

Y

Format: String, 50 Description: Closed list of values, the following values are allowed "Dispute Management"

ID

Y

Format: Numeric, 1-19 Description: Input should be RPID in case IDType = RPID Input should be Card Number in case IDType = CardNumber

IDType

Y

Format options: CardNumber RPID SavingAccount

Do not allow card number (its useless and so we prevent it from being stored unsecure)

RequestedResult

Y

Format: String, 50 Description:Closed list of values, the following values are allowed CardNumber, ProcessorAccountNumber

Output Parameters:

XML Samples

Input XML

<?xml version="1.0"?>
<PraxellXMLRequest>
  <AuthenticationDetails>
    <SessionID>1234567890</SessionID>
    <ClientSourceIP></ClientSourceIP> 
 </AuthenticationDetails>
 <ServiceDetails>
    <UniqueRequestId>963369551</UniqueRequestId>
    <ServiceName>RequestOTP</ServiceName>
  </ServiceDetails>
  <Origin>
    <OriginType>ExtAPI</OriginType>
  </Origin>
  <ServiceParams>
    <Purpose></Purpose>
    <ID>123456789</ID>
    <IDType>RPID</IDType>
    <RequestedResult>CardNumber</RequestedResult>
  </ServiceParams>
</PraxellXMLRequest>
<?xml version="1.0"?>
<PraxellXMLResponse>
     <ResponseDetails>
        <ServiceName>RequestOTP</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>
</ResponseParams>
</PraxellXMLResponse>
<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>RequestOTP</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>

Last updated