Topics | Products - Capture Plus

Quick setup guide – Address, Email and Phone Validation

  1. Who should use this guide?
  2. Adding address, phone and email validation to your site
  3. Mapping your fields
  4. Accessing field settings
  5. Field types available
  6. Reactivating setup
  7. Basic settings
  8. Limits
  9. Security
  10. Service control
  11. Advanced customisation

Who should use this guide?

If you already have a form on your website and wish to add address, phone or email validation this guide will get you up and running as quickly as possible. We have made integrating our services as simple as possible, with the majority of the process guiding you through step by step. You are not expected to have any technical expertise, but a basic understanding of HTML would be an advantage.

For more advanced, customised installations, please see our API pages:

Adding the PCA Tag to your site

Watch a video walkthrough of the setup process

  1. To get started, log into your PCA Predict account, select “New Service” from the left-hand menu and then click the “Set Up” button under Address, Email and Mobile Phone Validation.
    Setup new service
  2. Where will it be used
    If you are integrating with Salesforce, Microsoft Dynamics, Magento or Magento 2 select the integration option and choose the relevant application - your installation will be a little different, so on the next step, you will be taken to the associated app page where you can follow instructions for installation. For everything else, select "Custom built website" and enter the URL of the site you're putting the service into. Click "Next" to continue.
  3. Script include example
    Next you will be presented with a snippet of JavaScript code to add to your website. Copy the code generated for you and paste it into the <head> section in the HTML of your website.

    Tip: placing this code on each page of your site makes the setup process easier and is easy to do if you have a layout template for your site.

    Once you have finished editing the page, save and upload the new file to your servers and click the "Launch Setup" button on the setup screen.

  4. The setup process will now open your site using the URL provided earlier. The Tag setup will map the fields automatically.

Mapping your fields

When your site loads, you should browse to the page containing your form. Any address, email and phone fields will automatically be detected and mapped to our services.

  1. Try finding an address by simply typing any part of the address within your form field, a list of valid address should display below, matching as you type – like the example below. The more you type, the more accurate the results will become. Once you find the address you wanted, simply click it and the rest of your address fields should autofill.
  2. Try finding an address by simply typing any part of the address within the search box. the address validation will return a selection of relevant address, matching as you type. The more information you enter, the more accurate the results will become. Once you have found the address you were searching for, simply click it and the address validation will populate all of your address fields for you.
    1. If everything works as you expect it to, you can press the "save" button at the bottom of the setup window on the right hand side.
    2. If your fields aren’t quite mapping properly, or you want to customise any field settings, read the next section of this guide - Field types.

  3. Your address validation setup is now complete. All that is left to do is give your installation a name so you can reference it in the future. Then, if there are any more places you would like to install a service you can click the "Add another" drop down menu and select a service.

Remember: if at any point you get stuck or have questions regarding our products or setup process, please contact our support team or chat with us live from the setup screen.

Field types

The on-screen setup tool is capable of altering which form fields the service uses and how it interacts with your website. There are plenty of fine grain controls to perform most customisations. For anything more complicated, you can call our support team who should be able to help you figure out a solution.

Accessing field settings

  1. When the Tag is initially installed on a page it automatically detects the fields it could be installed into. If you would like to customise this mapping, or indeed if the mapping doesn't work, you can click on the "configure" button on the right hand side for the relevant service.
    Capture+ setup bar
  2. Address validation will automatically detect your address fields and color codes them, e.g. Shipping address and a Billing address. The settings for the corresponding fields will display the same colour on the right hand side.

    If all your address fields are not detected correctly, you can choose the right fields manually.

  3. If you’ve named your field names or ids conventionally (i.e. Line1, Line2, City, etc) the address validation service will try and match the correct field types to the relevant address fields on your form.
    Automatically matched fields
  4. To match a new field to a field type, click “Add a new field”. Now you can either manually choose your own field by name/id from the dropdown list under the “Your Fields” column, or you can click the selection button and then click the field on your form that you would like to use.

  5. Once you've selected the form field you want to put address validation on, you will need to pick a field type from the adjacent dropdown list under the “Our Fields” column. Field types correspond to a specific address component (i.e. Line1, Line2, City, etc). You can find out specific details regarding each of the types available in the Field types available section of this guide.

  6. If you need to remove any fields, click the bin icon on the right hand side: next to the unwanted field.

  7. To the right of each fieldset is a button to access additional settings for that field: . There are 4 settings to choose from and you can mix and match them as you please. These settings are:
    • Search - Turns the field into a search bar, showing the returned address results when a user starts typing their address into the field.
    • Populate - Populates the field with the relevant data after an address is selected.
    • Preserve - Once populated, the field is not changed by the address validation again. This can be useful if you need to manually make a change and make it persist on the form.
    • Country - Turns the field into a country dropdown list.
    Field type options
  8. When you are happy with your setup, click “Done” and then try searching for an address. If you are happy with the results, click the “Save” button at the bottom of the setup menu to save all changes.

At this point, the address validation will be Live and running on your website with all of the settings you have chosen. For added security, we advise you to look at the service settings on your account. You can find out the benefits of doing so in the Settings section of this guide.

Field types available

Below is a table of the most commonly used address fields available for address validation:


Field nameDescription
Line1-5The specific line number of the returned address
TownThe Town of the returned address
CountyThe County of the returned address
PostcodeThe Postcode of the returned address
CountryThe ISO 3166 Country name for the returned address
CompanyReturns the full company name where registered
Search InputSearch bar where all the address validation magic happens
Building NameName of the building for the returned address
Building NumberNumber of the building for the returned address
Sub BuildingThe Flat or Unit number within the building. i.e. Flat 1
StreetThe Street Name of the returned address
DistrictThe locality within the Town or City
County NameThe name of the County, Province or State, i.e. California
County CodeThe code of the County, Province or State, i.e. CA
2-Character ISO CodeThe ISO 3166 2-character Country Code for the returned address, i.e. GB
3-Character ISO CodeThe ISO 3166 3-character Country Code for the returned address, i.e. GBR
Formatted AddressThe FULL address in the correct standardised format

Whilst these fields will be enough for the majority of use cases, there is still plenty of scope to use many additional fields and formats.

Reactivating setup

If at any point you need to change the way a service is set up on a form, you can reactivate the setup process with the following steps.

  1. Log into your account, select "All Services" and click on the relevant address validation installation.
  2. You should now be presented with the setup options for your address validation installation. Select the "On Page Setup" tab.
  3. Click on "Activate setup" to start the setup process again. You will be taken back through the setup process for mapping your address fields.
    On page setup

Setting options

Within your PCA Predict account, you can change your service settings and take further control over your usage. These settings break down into three main categories: Basic Settings, Security, and Control. The next sections of this guide will focus on each of the categories and walk you through how to make the most of the choices available to you.

NOTE: If you make any changes, you will need to click the “Save” button for those changes to take effect.

Basic settings / Overview

The basic settings tab (labeled just as "Overview") gives you the below options to adjust accordingly.

  • Name - This allows you to customise the name of the key selected. This is primarily to help you identify your own keys more easily. This can be particularly useful if you are using more than one key under one account.
  • Internal use - Are you using the service internally, e.g. for your CRM or office systems, (not on a public website).
  • Unlimited use - By selecting “Yes” you will be allowing an unlimited number of lookups for this key. This should be fine if your account is well funded and you expect a high rate of traffic. For smaller accounts and tighter cash flow control, you can select “No” and specify the cost of lookups to cap spending for each day.
  • Daily limit - Only visible when “Unlimited use” is set to “No”. Here you specify the daily amount to cap your spending at. Customers will still be able to fill in the rest of the form as normal, they just won’t have the validation experience which might impact your form completion rate.
Capture+ settings

Limits

The security tab helps you maintain control over who can use your keys, which of your websites the service requests should be made from, and place limits on the number of requests made by individual IP addresses. We strongly recommend that you complete these settings.
These settings can be used as follows:

  • Internal Use - Flags whether the service is being used by users of a public website, or members of staff inside a company.
  • Unlimited use - To set a daily spend limit on the installation, set this to "No", otherwise there will be no restriction on daily spend.
  • Daily Limit - The maximum spend level allowed on this installation per day. Set this to a sensible level that you do not want to go over and that won't affect expected daily usage.
Capture+ limits

Security

The security tab helps you maintain control over who can use your keys, which of your websites service requests should be made from, and place limits on the number of requests made by individual IP addresses. We strongly recommend that you complete these settings.
These settings can be used as follows:

  • Valid URLs - To help prevent fraudulent or accidental use of one of your keys across domains, simply add the URLs that you expect the address validation requests to be coming from. However, you will also need to specify any subdomains and combinations of URLs that might be used. i.e. http://www.mysite.co.uk, http://www.mysite.com, http://mysite.co.uk, etc.
  • Valid IPs - To restrict address validation requests to specific IP addresses, simply enter the external IP address of the machine in question and click “Add”. This is mostly useful if you need to restrict keys for your own office or individual teams. DO NOT set this if address validation is available on a public website form.
  • IP Limiter - Similar to the “Daily Limit” under basic Settings, The IP Limiter allows you to place request limits against a group of IP addresses. This should help manage your cashflow and cap individual usage. To make use of the setting select “Yes”. Enter the IP address you wish to limit in the “Limiter Exclusions” box and then click “Add”. You can add as many IP addresses as you like. Next set the limit as the maximum number of daily requests you wish the group of IPs to be able to make. Any valid IPs not included within the limited group will not be affected by the request limits.
Capture+ security

Address validation control

The control settings help you manage the localisation of your forms. Under the Control tab you can control country settings and default languages. These settings are explained below.

  • Available countries - To limit which countries are available to customers using the form, select the country(s) you want lookups to be available for and click the “>” button to add it to the “Selected List”. NOTE: The order in which they appear within this list will be the same order they will appear on the address validation form. Countries can also be removed from the list using the “<” button.
  • Default country - By default address validation will try and determine which country your customer is connecting from by looking up their IP address. You can override this and force any country of your choice by selecting one from the dropdown list. This may be useful if you expect the majority of your customers come from one country.
  • Language - Address validation results can be returned in a variety of languages that use Roman characters. Whilst the default setting is to match the user’s browser settings, you can specify an overriding language to use by selecting one from the dropdown list. Currently, address validation can support the following languages: Dutch, English (UK), English (Canada), English (US), French, German, Hungarian, Italian and Spanish.
Capture+ control

Phone validation control

Capture+ control

Email validation control

Capture+ control

Advanced customisation

Custom options

If you want to customise the look and feel of address validation, you can set advanced options by including this JavaScript snippet in your page. For a full list of options read the reference documentation.

    <script type="text/javascript">
        pca.on("options", function (type, id, options) {
                if (type == "capture+") { 
                    options.suppressAutocomplete = false;
                }
            });
    <script>

Custom events

If you call any custom methods or listen to events, you will need to include this snippet in your page to get a reference to the control objects as they load. A full reference can be found in the documentation.

    <script type="text/javascript">
   pca.on("load", function(type, id, control) {
                    control.listen("populate",
                        function(address) {
                            alert("User selected: " + address.Id);
                        });
                });
    <script>

Loading problems

If address validation is not loading at the correct time, you can include this snippet in your page (directly below your address fields).

    <script type="text/javascript">
       ?pca.load();? 
    <script>

Further information

For further information or help with any questions you may have about address validation, contact our dedicated support team who will be more than happy to help.