Aura Setup and Support

Learn how to set up online forms, your shopping cart, and further customizations for Aura.

Aura Customization

Adding and/or Hiding Static Defaulted Values

The Aura form can be enhanced further to allow default values to be added directly within the script once it has been embedded within the webpage or via the URL of the webpage directly. These defaulted values will be visible to the end user unless additional hidden values are included within the script (certain values only).

Method 1: Adding Values Via the Script Directly

The below table of variables can be appended to the value of the ‘src’ tag in the script, following the PaymentBoxPID variable by using the following format &[variable]=[value].

For example, to default the Country field value to US:

  • Copy of the original script copied from the Aura setup page:

<script type="text/javascript" src="https://www.iatspayments.com/AURA/AURA.aspx?PID=PACE4C7CC915152DCB"></script>

  • Copy of the script after appending the default values to set the default Country field to US:

<script type="text/javascript" src="https://www.iatspayments.com/AURA/AURA.aspx?PID=PACE4C7CC915152DCB&Country=US"></script>

 

To hide fields within the Payment section and therefore the defaulted value, un-check the “Visible” checkbox beside the field within Aura setup. Even though the field is hidden, the defaulted value is still pushed to iATS.

Please note that some Recurring Schedule fields do not have a “Visible” checkmark option, such as the End Date. In order to hide these values (only values indicated in table below), specific variables can be hidden by using the following format: &[Hidevariable]=[True]

 

For example, to hide the Recurring End Date:

  • Copy of the script after hiding the defaulted End Date:

<script type="text/javascript" src="https://www.iatspayments.com/AURA/AURA.aspx?PID=PACE4C7CC915152DCB&HideRecurringEndDate=True"></script>

 

The following input fields can be defaulted with specific values for the end user using the script method above:

Variable to use for Defaulting option Defaulted Field Additional Information
FirstName First Name  
LastName Last Name  
Address Address  
Country Country

For Example:

US for United States

CA for Canada

GB for United Kingdom

Note: Any country can be set as default, and should use the Country name as listed within the Country drop down menu.
City City  
State State

Note: State name or state code can be used as default value if the Country is US/CA/UK. Both are acceptable.

For US example:

AK or Alaska = both values will work

For CA example:

BC or British Columbia = both values will work
City City  
ZipCode Zip Code  
Fax Fax  
Phone Phone  
Phone2 Mobile  
EMail Email Use variable as capital “E” and “M”, and lower case “ail”.

ReEnterEmail

Re-enter Email  
Comment Comment  
Item1, Item2, Item3, etc. Item’s 1 through 6 (Survey Answer Text Box Fields)

Applies to the survey answer text field (not visible in the Aura set-up payment tab).

When the Items are utilizing the radial or pick list options they cannot be defaulted.
BeginDate ** Beginning Date

Date must be entered in format:

mm/dd/yyyy

**Note: Only the FULL begin date can be set as a default. For example, you cannot default the day or month only. Date cannot roll forward.
EndDate Ending Date

Date must be entered in format:

mm/dd/yyyy

Note: Only the FULL end date can be set as a default. For example, you cannot default the day or month only. Date cannot roll forward.
RedirectTime

Sets value for the length of time Redirect page displays

(In milliseconds)
2000 (2 seconds) by default.  Accepted range is from 100 (0.1 seconds) to 15000 (15 seconds).
TotalAmount Sets the total Amount of the end user’s payment. The default TotalAmount will only be displayed when HideAmountInfo is set true.
TotalDescription For example “Total:”

Set the value for the total description. 

 

The following fields can be hidden from the end user using the script method above:

Variable to use for Hiding option Defaulted Field Additional Information
HideRecurringEndDate Hides Recurring End Date visibility Use true to hide the recurring End Date field.
HideAmountInfo Hides the Amount section.  End user cannot select an amount. Use true to hide Amount section of the Aura form.
HideWeekly Hide weekly recurring schedule type.

Use true to hide the weekly recurring.

HideMonthly Hide monthly recurring schedule type. Use true to hide the monthly recurring.
HideQuarterly Hide quarterly recurring schedule type. Use true to hide the quarterly recurring.
HideAnnually Hide annually recurring schedule type. Use true to hide the annually recurring.

 

Method 2: Adding to URL

The below table of variables can be appended to the URL by using the following format:

?[variable]=[value].

For example, to default the Country field value to US:

http://home.iatspayments.com/test?Country=US

Using this method you have the option of utilizing the BELOW table of values, but may also add your own custom fields if desired. Please note these custom fields will be sent to iATS and included in the “Aura Post Back” contents if collecting data via post, however does not interact with our Salesforce application Brickwork.

  • For example, to default a custom field to Generic Annual Appeal:
    http://home.iatspayments.com/testFundName=GenericAnnualAppeal
  • To combine variables include an “&” ampersand after each entry, such as:
    http://home.iatspayments.com/testIATS_PaymentItemInput_CountryUS& FundName=GenericAnnualAppeal


The following input fields can be defaulted with specific values for the end user using the URL method above:

Variable to use for Defaulting option Defaulted Field Additional Information
Title Title

Values accepted:

Mr.   = Mister

Mrs. = Missus

Ms.   = Miss
Dr.    = Doctor

Prof.  = Professor

Rev.   = Reverend

Other = Other

Note: These values are case sensitive and it should be added exactly as indicated above.
FirstName First Name  
LastName Last Name  
Address Address  
City City  
State State

Note: State name or state code can be used as default value if the Country is US/CA/UK. Both are acceptable.

For US example:

AK or Alaska = both values will work

For CA example:

BC or British Columbia = both values will work
Country Country

Values accepted:

US for United States

CA for Canada

GB for United Kingdom

Note: Any country can be set as default, and should use the Country code (not the Country name).

For example:
FR for France

DE for Germany
ZipCode Zip Code  
Phone Phone  
Phone2 Mobile  
Fax Fax  
EMail Email Use variable as capital “E” and “M”, and lower case “ail”.
ReEnterEmail Re-enter Email  
Comment Comment  

 

Pre-populating Dynamic Values

The Aura form can be customized to pre-populate dynamic values for the end user. For example, if a member is signing up for a yearly membership, a series of questions can be asked on a prior web-page. Depending on the responses to the questions, a different dollar amount can be pre-populated in the Total field.

 

You can pre-populate values by appending additional values to the script or the page URL where the Aura form is embedded. All variables can be appended by using the following format: &[variable]=[value].

The variables' names must be standard ones within the default tables above in order to pre-populate the proper values.

 

For example, if the page URL where Aura form is embedded is https://www.SAMPLE.com, the correct method to pre-populate the first name and last name is to update the URL to https://www.SAMPLE.com?Firstname=first name&LastName=last name.

Note: Please be aware that if the same variable is appended to both Aura script and page URL, the values within the Aura script will be overwritten.

 

Email Customization

Additional customizations can be applied to the Notification Email that is sent to the end user.

When the variables listed below are added to the Email set-up, the information will be contained within the body of the email.

If the end user did not provide information in the field, for example if the Comment field was left blank, the variable field within the email body ([#COMMENT#]) will contain a blank space.  To avoid this, the field can be marked as required in the Aura Setup. 

Note:

  • Emails containing <img> tags may be blocked by the end user’s email account due to security concerns, and may prevent the email from being delivered successfully. Images can be added at your discretion.
  • The below values are case sensitive. Please use only uppercase letters as per table.

 

Optional Variables Comments
[#FIRSTNAME#] First Name
[#LASTNAME#] Last Name
[#TITLE#] Title
[#EMAIL#] Email Address
[#ADDRESS#] Street Address
[#CITY#] City
[#STATE#] State/Province
[#ZIPCODE#] Zip/Postal Code
[#COUNTRY#] Country
[#PHONE#] Phone Number
[#MOBILE#] Mobile/Cell Number
[#FAX#] Fax Number
[#COMMENT#] Comment Line
[#ITEM1#] Survey Question Label, Item 1
[#ITEM2#] Survey Question Label, Item 2
[#ITEM3#] Survey Question Label, Item 3
[#ITEM4#] Survey Question Label, Item 4
[#ITEM5#] Survey Question Label, Item 5
[#ITEM6#] Survey Question Label, Item 6
Note that the donor’s responses cannot be included in the email at this time.  
[#ACCOUNTNUMBER#] Portion of Bank Account or Credit Card Number
[#ACCOUNTTYPE#] Account Type (Checking/Saving)
[#AGENCYNAME#] Organization Name
[#CUSTOMERCODE#]

Recurring Donation Customer Code Token

[#AUTHCODE#] Authorization/Rejection Code for Transaction
[#AMOUNT#] Total Dollar Amount
[#TRANSACTIONDATE#] Date of Transaction
[#SHOPPINGCARTTABLE#] Details when using the Shopping Cart option. Includes: Product Name, Option1, Option2, SKU, Quantity, Price, Quantity Price
[#AMOUNTITEM1#] Amount Label 1
[#AMOUNTITEM2#] Amount Label 2
[#AMOUNTITEM3#] Amount Label 3
[#AMOUNTITEM4#] Amount Label 4
[#AMOUNTITEM5#] Amount Label 5
[#AMOUNTITEM6#] Amount Label 6
[#AMOUNTITEM7#] Amount Label 7
[#AMOUNTITEM8#] Amount Label 8
[#AMOUNTITEM9#] Amount Label 9
[#AMOUNTITEM10#] Amount Label 10
[#AMOUNTITEM11#] Amount Label 11
[#AMOUNTITEM12#] Amount Label 12
[#AMOUNTITEM13#] Amount Label 13
[#AMOUNTITEM14#] Amount Label 14
[#AMOUNTITEM15#] Amount Label 15
[#AMOUNTITEM16#] Amount Label 16
[#AMOUNTITEM17#] Amount Label 17
[#AMOUNTITEM18#] Amount Label 18
[#AMOUNTITEM19#] Amount Label 19
[#AMOUNTITEM20#] Amount Label 20

 

Adding Images to Description Using HTML

Format for placing an image:

<IMG SRC=’image.gif’ ALT="some text" WIDTH=32 HEIGHT=32>

Note: The value in width and height are just examples. The ALT stands for ‘alternate text’. It tells the browser that if it cannot find the image, it just displays the text. It also tells what the image is about if anyone cannot view the image.

  • SRC stands for “source”. This is an attribute. It’s telling the browser where to go to find the image. You will need to indicate the full URL of the image in the source attribute.

For example: src=http://www.testwebsite.org/publicImages/thumb_donorbutton2.jpg

Note: The URL of the image above is just an example. You will need to provide the correct URL.

  • Please note that when adding an image in the Description box, the URL value in SRC should be enclosed in single quotes and not double quotes.

To make the image work in the Description box, here is the correct code:

<h2>

<img src='http://www.testwebsite.org/publicImages/thumb_donorbutton2.jpg' alt="donorbutton2.jpg" title="donorbutton2.jpg" border="0" height="59" width="250" />OnlineDonations for the Annual Fund of the Generic Foundation

</h2>

 

The following are basic image formats (and recommended) on the web:

  • GIF
  • JPEG or JPG
  • PNG

 

If you have any questions regarding adding images using HTML, please contact iATS Customer Care at 0808-234-0466, or iatscs@iatspayments.com.

Contact Us