Developer API

Overview

Account API

Transfer API

Validate Out of Wallet Questions

POST /registrations/{RegistrationID}/outofwalletanswers/validate

This method validates the Registration ID by sending the customer’s answers to OOW security questions as part of the request.

If the customer’s status is Validated: Out of Wallet Questions, this step must be performed to fully validate the customer’s profile before an account can be created. If the request is successful, the customer’s status will be set to Validated.

Request Objects

Field Type Format Required Description
RegistrationID String Max 19 characters Yes RegistrationID of the profile to be validated
QuizID String Max 50 characters Yes QuizID from the quiz given to the customer
Answers[] Array Yes Array of quesions and choices
QuestionID String Max 100 characters Yes ID for question
ChoiceID String Max 100 characters Yes ID for choice selected by customer

Request Sample

{

 “QuizID”: “11020744560576”,

“Answers”: [

 {

  “QuestionID”: “11021629798615”,

  “ChoiceID”: “11026207599274”

 },

 {

  “QuestionID”: “11021629798616”,

  “ChoiceID”: “11026207599280”

 },

 {

  “QuestionID”: “11021629798617”,

  “ChoiceID”: “11026207599286”

 }

]

}

Response Object

Field Description
ResponseCode See Response Codes
ResponseDescription

BonusQuiz

A bonus question to be presented to the customer. This question is returned only with Response Code 60.
QuizID Unique ID for quiz
OOWQuestions[] Array of questions
QuestionID Unique ID for question
QuestionText Question text
Choices[] Array of choices
Choice ID Unique ID for choice
ChoiceText Choice text

Response Codes

Response Code Detail Code Response Message
0 Validated without qualifiers.
30 Validated; non-reloadable verified
40 Validated; documents required
50
Validation Failed
2010 Address verification failure
2020

Age verification failure (under age)

2030 Fraud check failure
2040 Ineligible for account
2050 Too many accounts
2060 Other validation failures
60 Validated; Out of Wallet questions

Response Sample

{

 “ResponseCode”: “60”,

 “ResponseDescription”: “Out of Wallet Questions”,

 “BonusQuiz”: {

  “QuizId”: “11020744560576”,

  “OOWQuestions”: [

  {

   “QuestionId”: “11026208623062”,

   “QuestionText”: “What month was ‘Khalid Salah’ born in?”,

   “Choices”: [

   {

    “ChoiceId”: “11026208623062”,

    “ChoiceText”: “February”

   },

   {

    “ChoiceId”: “11026208623063”,

    “ChoiceText”: “April”

   },

   {

    “ChoiceId”: “11026208623064”,

    “ChoiceText”: “July”

   },

   {

    “ChoiceId”: “11026208623065”,

    “ChoiceText”: “September”

   }]

 }]

}