|
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
- Use of these fields requires that the field "SHIPPING" be set to "YES"
- Use of these fields requires that the field "PHONE" be set to "YES"
- 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
|
