Developers Page

IPPS Fields and Values

IPPS can automatically fill-in many of the fields on its forms with information you have already gathered prior to sending the customer to IPPS. IPPS can also return many of the fields back to a script on your site using the 'POST' method described in the Purchase Site Set-up. The first list below are the names of the fields that can be submitted to IPPS and the second list is the field names that can be returned by IPPS to a script on your site.

Below is a complete list of all the fields that can be submitted to IPPS:
 
merchant_account
The account name supplied by Right Connection
mode
Should be set to "remote"
ALIAS
Allows an ALIAS name (i.e. the name of your Web site) to appear on the customer's receipt
firstname
The customer's First Name
lastname
The customer's Last Name
email
The Customer's E-mail address
username
The User ID selected by the customer
password
The Password selected by the customer
address1
The customer's street address line #1
address2
The customer's street address line #2
city
The customer's City
state
The customer's State
zip
The customer's Zip/Postal Code
country
The customer's 2 character ISO country code
cardtype
Type of credit card used
exp_mon
The expiration month of the credit card used
exp_year
The expiration year of the credit card used
card_number
The credit card number
cvv2
The credit card security code (3 or 4 digits)
trans_amount
The amount of the transaction
trans_response
The transaction approval code
user1
Pass-thru variable field and used for some IPPS command functions
user2
Pass-thru variable field
user3
Pass-thru variable field and used for some IPPS command functions
ship_name
The Shipping Name (See Note 1)
ship_address
The Shipping Address (See Note 1)
ship_city
The Shipping City (See Note 1)
ship_state
The Shipping State (See Note 1)
ship_zip
The Shipping Zip/Postal Code (See Note 1)
ship_country
The Shipping Country (See Note 1)
ship_phone
The Shipping Phone (See Note 1)
ship_zip
The Shipping Zip/Postal Code (See Note 1)
home_phone
Home Phone Number (See Note 2)
work_phone
Work Phone Number (See Note 2)
fax_phone
Fax Phone Number (See Note 2)
REBILL
Enable the Automatic Rebilling System (See Note 3)
REBILL_START
Start the Automatic Rebilling System in X days (See Note 3)
REBILL_CYCLE
How often the Automatic Rebilling should occur in X days (See Note 3)
REBILL_AMOUNT
How much the Automatic Rebilling System should charge (See Note 3)
ADMIN_EMAIL
Email address where an additional copy of the merchant's reciept will be sent to
  1. Use of these fields requires that the field "SHIPPING" be set to "YES"
  2. Use of these fields requires that the field "PHONE" be set to "YES"
  3. Use of these fields are covered in more depth in the Automatic Rebilling section

Below is a list of all the fields that will be returned by IPPS after an approved transaction when user1 is set to "POST" and user3 is set to "USE_PASSWORD":

firstname
The customer's First Name
lastname
The customer's Last Name
email
The Customer's E-mail address
username
The User ID selected by the customer
password
The Password selected by the customer
expdate
The expiration date for the User ID expressed in YYYYMMDD format
address1
The customer's street address line #1
address2
The customer's street address line #2
city
The customer's City
state
The customer's State
zip
The customer's Zip/Postal Code
cardtype
Type of credit card used
exp_mon
exp_year
The expiration year of the credit card used
card_number
The credit card number with the last 8 digits replaced by "XXXX"
trans_amount
The amount of the transaction
trans_approved
Will be "APPROVED" for valid transactions
trans_response
The transaction approval code

Below is a list of all the fields that will be returned by IPPS after an approved transaction when user1 is set to "POST":

firstname
The customer's First Name
lastname
The customer's Last Name
email
The Customer's E-mail address
home_phone
The Home Phone Number provided by the customer
work_phone
The Work Phone Number provided by the customer
fax_phone
The Fax Phone Number provided by the customer
address1
The customer's street address line #1
address2
The customer's street address line #2
city
The customer's City
state
The customer's State
zip
The customer's Zip/Postal Code
country
The customer's country
cardtype
Type of credit card used
exp_mon
The expiration month of the credit card used
exp_year
The expiration year of the credit card used
card_number
The credit card number with the last 4 digits replaced by "XXXX"
trans_amount
The amount of the transaction
trans_approved
Will be "APPROVED" for valid transactions
trans_response
The transaction approval code
user1
The contents of "user1" that was sent to IPPS
user2
The contents of "user2" that was sent to IPPS
user3
The contents of "user3" that was sent to IPPS

Below is a list of all the fields that will be return via a 'GET' command to the URL supplied in the next_url field when user1 is set to FORCE and user3 is set to USE_PASSWORD. If the 'GET' command fails, IPPS will automatically default back to the user1="POST" method.

username
The User ID selected by the customer
passwd
The Password selected by the customer

Developers Integration Page  |  Technical Support Help Page


© Right Connection 2002 - All Rights Reserved