Skip to main content
knowledgecenter.avangate.com

Add checkout fields

Overview

Define additional fields to be displayed in the shopping cart, helping you collect extra information from your shoppers. You can configure custom fields to be displayed at both product and order level.

How do I receive additional fields?

Customer specific information collected via custom additional fields is sent in several ways:

  • in the "Order notification email "- sent by the Avangate system, information filled by your customers will be sent along with all the order information in the Additional Information section.
  • in the "IPN (Instant Payment Notification)" if this service is enabled, the additional fields are included in the HTTP POST sent by the Avangate system.

Additional fields are not included by default in the IPN HTTP POST. To include these fields, as well as other additional order information you have to check CUSTOM_FIELDS[] on the IPN Settings page.

The following IPN variables are available:

Order additional fields

Field Description
IPN_CUSTOM_TEXT[] array with all the custom fields texts set per order.
IPN_CUSTOM_VALUE[] array with all client input corresponding for the text.

Example

IPN_CUSTOM_TEXT[] 0 Where did you first hear about us?
  1 Would you like to receive regular updates?
IPN_CUSTOM_VALUE[] 0 From a friend
  1 CHECKED

Product additional fields (dynamic fields):

Product name: 123456 
Product ID in the Avangate system: 123456

Field Description
IPN_CUSTOM_123456_TEXT[] array with all the custom fields texts set per product.
IPN_CUSTOM_123456_VALUE[] array with all client input corresponding for the text.
Example
IPN_CUSTOM_123456_TEXT[] 0 Product code
IPN_CUSTOM_123456_VALUE[] 0 123456

Additional information can be found in the Technical documentation section.

Create custom fields

  1. Go to Setup -> Ordering options.
  2. Click Manage additional order fields.
  3. Use the Add new field section to define each new field. Enter the Field identifier. Use unique identifiers for all your fields. Note: This field accepts only alpha-numeric characters. If you leave this field empty, Avangate generates a random value as identifier.
  4. Enter the Field text (the name of the field).
  5. Set the Field type. There are four available types.
    • Textbox allows shoppers to write what they want in the field. You can use it to collect feedback or opinions on the shopping experience, for instance.
    • Checkbox allows shoppers to select various options. You can use it for a quick survey.
    • Listbox displays a drop-down list your shoppers can select items from.
    • Hidden helps you define custom URL parameters for tracking purposes. For details on this option, read our dedicated article.
  6. Use the Apply to drop-down to choose whether the field should apply at product or order level. 
  7. Use the Validation rule field to specify the regular expression to validate the field values.
  8. Click Create field to save the new field.

Enable product level additional fields

Requirement

Follow the steps in the Create custom fields section to create new fields and apply them at Product level. Then, follow the steps below to assign the field to a product.

  1. Go to Setup -> Products.
  2. Click Edit on the product you want to assign the field to.
  3. Go to the Information tab and scroll to the bottom of the screen. You'll find the previously defined additional fields in the Order additional fields section. All new fields are disabled by default.
  4. Check the Enabled option on the Order page column corresponding to the field you want to use. Check the Required checkbox if you want the field to be mandatory during the checkout process.
  5. Click Save.

Enable order level additional fields

Requirement

Follow the steps in the Create custom fields section to create new fields and apply them at Order level. Then, follow the steps below to assign the field to an order.

  1. Go to Setup -> Ordering options.
  2. Scroll down to Additional order fields.
  3. Check the checkbox next to the field you want to use. Check the Required checkbox if you want the field to be mandatory during the checkout process.
  4. Click Save settings at the bottom of the page.