About Net-Iden Products FAQ Rates Industries Developers         Sign In
  Developers Area  I   Integration Guide
  Release: 0.905   I   Last Update: May, 2009
  PHONE VERIFICATION  
 
Overview
 
 
End user experience
 
 
Types of calls
 
 
API Input variables
 
 
Requesting a phone call
 
 
API Output variables
 
 
Checking the status of a phone call
 
 
Output variables for RequestStatus API
 
 
Integrating with IP Intelligence
 
 
Understanding the <STATUS> field
 
 
Calling country codes
 
 
Placing a country code selection in your website
 
 
Script Builder
 
 
Generating a random PIN
 
 
Getting your visitor's IP address
 
  IP & BANKING INTELLIGENCE  
 
Overview
 
 
API - Input variables
 
 
Calling IPintel.Netiden API
 
 
API - Output variables
 

 

 
  Net-Iden Documentation
 

API INPUT VARIABLES


The Net-Iden Phone Verification handles the following input variables:

AllowCell

For international calls, this field set if a verification call can be placed (or not) to a Cell Phone.

Usage:

  • AllowCell=0 or AllowCell=1

Values:

  • 1 = Allow Cell Phones
  • 0 = Do not allow Cell Phones
  • Default Value = 0

Country

This variable refers to the country code of the phone number to be called. It is a mandatory field. For the United States, this value is 1; for Argentina it is 54.

Please refer to the COUNTRY CODES page in this manual to learn more about country codes.
Usage:

  • Country=<Country Code>

Example:

  • Country=1                         (USA)
  • Country=44                       (UK)
  • Country=54                       (Argentina)

Phone

This variable is the phone number at which the NETIDEN servers must perform the verification call. The format is {area code}{phone number}. You must not enter the country code in this field.

For example, for a US phone, you may enter 5553261145, but 15553261145 is unacceptable.
Usage:

  • Phone=<phone number with area code,  and without the country code>

Example:

  • Phone=5558742369

PIN

This is the PIN number that your user will be requested to validate over the phone.
Usage:

  • PIN=<PIN number, 4 numeric characters>

Example:

  • PIN=3492
  • PIN=3447
  • PIN=8201
  • PIN=3589

TransactionID

This field does not affect the use of Net-Iden services. It is used for informative purposes only. For example, if the ID of your shopping cart is 3873644, you can use this field to pass that parameter to the Net-Iden servers, so after the phone call is placed and Net-Iden returns the results, that field is passed back to you.
Usage:

  • TransactionID=<Your_Transaction_ID>

Example:

  • TransactionID=Paypay-344387234
  • TransactionID=Verisign3442234324
  • TransactionID=34554343

CallType

This variable defines the type of call you wish Net-Iden to perform. 
Possible values:

  • 1
  • 2
  • 3
  • 4
  • 1) The user receives a phone call, in which we indicate the PIN number he/she should enter in your website in order to validate his/her phone number. In this case, the message played will be “Hello. Thank you for using our phone verification system. Your PIN  number is XXXX. Once again, your PIN number is XXXX. Goodbye!"

  • 2) The user receives a phone call requesting him/her to enter the PIN number that he/she was provided through your website. The message played will be “Hello. Thank you for using our phone verification system. Please enter the PIN number on your screen, followed by the pound key”. <PIN ENTERED> “Thank you for confirmation. Goodbye!”

  • 3) This option is used to validate a change of password. If your user attempts to change their password in your website, there will be a phone call to the number you have registered in your database playing the following message: “Hello. Thank you for using our phone verification system. To change your password, press pound now”. Once the user presses the pound key on his/her telephone keypad, Net-Iden will validate this action and the password change will be effective in your website.

  • 4) This option is used to validate a login process. If your user attempts to login to your website, there will be a phone call to the number you have registered in your database playing the following message: “Hello. Thank you for using our phone verification system. To access your account, press pound now”. Once the user presses the pound key on their telephone, NETIDEN will validate this action and the login to your website will be effective.

Usage:

  • CallType=<number> where number = 1, 2, 3 or 4

Example:

  • CallType=1
  • CallType=2
  • CallType=3
  • CallType=4

Entering a value different than 1, 2, 3 or 4 will return an API error.

UID

Your Net-Iden user ID. This is a mandatory field.

Usage:

  • UID=<Your User ID>

AID

Your authentication ID. This is a mandatory field.

Usage:

  • AID=<Your Authentication ID>

To learn about your UID and AID values, please login to your Net-Iden account and click the My Account link.

Language

The language in which you wish the Net-Iden servers to place the call. Messages are available in the following languages: English, Spanish, French, Russian, Chinese, Dutch, Italian, Portuguese and Japanese.

Usage:

  • Language=<Language>

Example:

  • Language=English
  • Language=Spanish
  • Language=French

If you refer to these variables directly from a form, they can be set as a textbox, hidden field, list/menu, checkbox, radio button, etc.

DevID

Your Developement Partner Program ID (if applies).

Usage:

  • DevID=<Your Development Partner Program ID>

Example:

  • DevID=1259683

IP

This field gathers information about the geographical location of your user(s). If you do not know how to pass this parameter from your website, please click here.

Usage:

  • IP=<ip address>

Example:

  • IP=192.168.2.36

 



 
 
            Development Partner Program    I    Terms of Use    I    Privacy Policy    I    Contact Us
 
  Copyright © 2009 Net-Iden. All Rights Reserved.