1. Home
  2. Docs
  3. Authentification
  4. OTP User Authentication (One time Password)
  5. Validate Challenge

Validate Challenge

To validate Challenge you will use:

  • Bizao-URI: /challenge/v1/challenges/{challengeId}
  • Bizao-Host: api.bizao.com

You will use the same Header and Body parameters as previously except for the imputs parameters:

ParameterUsageDescription
inputsMandatoryJSON array of {key,value} entries contain all the necessary inputs to perform the challenge:
  • end-user MSISDN
  • confirmationCode, the OTP received by the end-user (valids for 15mn only)
  • info, always with “OrangeApiToken,ise2” as value

A sample request :

curl -i -X POST \
https://api.bizao.com/challenge/v1/challenges/5af9aef17970x54259cec117 \
-H 'authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'cache-control: no-cache' \
-H 'content-type: application/json' \
-d '
{
"challenge": {
"method": "OTP-SMS-AUTH",
"country": "CIV",
"service": "BIZAO",
"partnerId": "PDKSUB",
"inputs": [{
"type": "MSISDN",
"value": "+22500000000"
},
{
"type": "confirmationCode",
"value": "9683"
},
{
"type": "info",
"value": "OrangeApiToken,ise2"
}
]
}
}'

Success validate challenge response

IMPORTANT

OrangeApiToken refers to BIZAO_TOKEN in your future calls and ise2 to BIZAO_ALIAS. The value of these 2 types may change in the next BIZAO API version and becoming more generic.

{
"challenge": {
"method": "OTP-SMS-AUTH",
"result": [{
"type": "OrangeApiToken",
"value": "B64gdlRJs1cgHHAGnAGHOzufNfm+FC9SiN/Gx6m/FGeuzU+mbJg+hqimCj+iewAIEgq|MCO=OCI|tcd=1527066723|ted=1527066823|rlVNKuyQ8P/Qb6RDaMSlVPUCz5Y="
}, {
"type": "ise2",
"value": "PDKSUB-200dM50oiCPDlihWwXlf9rNmegxeQjC8eX/EvF8e/BJAyg="
}],
"country": "CIV",
"service": "BIZAO",
"partnerId": "PDKSUB",
"inputs": [{
"type": "MSISDN",
"value": "+22577531300"
}, {
"type": "confirmationCode",
"value": "9683"
}, {
"type": "info",
"value": "OrangeApiToken,ise2"
}]
}
}

Was this article helpful to you? Yes 1 No

How can we help?