Getting started
Your first installation
It’s easy and free to set up your first installation. Once you sign up you’ll be taken through the steps required to install AddressComplete on a website:
- Enter the URL on which you will be using AddressComplete. This will secure the installation to this URL so no one else can use it on their website.
- Copy and paste the code snippet into the HTML source of your web page and upload it to your server.
- Load the page in your browser and follow the steps to match your address fields to the appropriate AddressComplete address result.
- AddressComplete is now working on your website. We recommend you tailor the installation by adding extra information for added security.
Now all you need to do is add credit at the end of your free trial to keep things running.
What’s a code snippet?
AddressComplete uses JavaScript code to run on your page, but it’s all generated by us. The code snippet is just a few lines of HTML code that tells your web page where to find the unique code for your installation and how it should look. All you need to do is copy and paste it into the HTML code for your web page wherever you want it to appear (typically above your address form).
Can I use AddressComplete on multiple sites?
Yes! We recommend you create a new installation for each site on which you use AddressComplete so you can tailor the security for each installation. Just set up a new installation whenever you need it—there’s no charge.
How can I secure my installation?
There are several things you can do to make sure your installation remains secure.
- Daily limit – the maximum spend allowed in a day for an installation.
- Valid URLs – the allowed URLs on which people will be able to use an installation.
- IP limit – the maximum number of requests allowed by any IP address in a day. IP addresses can be excluded from this restriction if required.
How do I purchase AddressComplete?
Once you’re happy with how AddressComplete is working, select the “Top up” button on the overview screen of your dashboard, or use the “Top up” link at the top of your dashboard pages. Choose the plan that’s most appropriate for your expected usage and enter your card details to instantly add credit to your account.
The Dashboard
How do I top up?
Use the “Top up” button on the overview screen of your dashboard, or select the “Top up” link in the menu at the top of each dashboard page. Choose the most appropriate plan for your usage and follow the steps to pay by card and instantly add credit to your account.
How do I edit my installation settings?
Sign in to your account to see your installations. Select an installation to view information about that installation and edit the settings. Any changes you make are saved automatically.
Can I customize an installation?
Yes. The following settings can be customized:
- Countries limiter – limit address lookups to a list of countries.
- Find country by IP – use the IP address of users to determine their country.
- Single language – limit AddressComplete to using one language or select the appropriate language from the selected country.
- Suggestion text – the text in the AddressComplete lookup box that tells users what to do.
- Valid IP addresses – limits AddressComplete to specific IP addresses/users.
What‘s the difference between ’enabled‘ and ’disabled’?
If an installation is enabled it will be visible to users and available for use. A disabled installation will be hidden from users, so is effectively removed from any web pages it’s installed on.
How can I get a copy of a receipt?
Sign in to your account. From the menu at the top of the page, select “Settings and Billing” and then “Receipts”. Select the “View Receipt” button next to a receipt to obtain a copy.
AddressComplete Basics
Why use AddressComplete?
Using AddressComplete to validate and capture address details has three main advantages.
- Firstly, it significantly speeds up the process of entering addresses for your customers because it cuts keystrokes by around 80%.
- Secondly, it ensures that addresses in your database are in a standardized, consistent format, reducing the likelihood of duplicates.
- Thirdly, it populates your database with accurate addresses, so your deliveries and invoices will arrive at the right place.
What benefits does international addressing provide?
As well as validating overseas addresses, AddressComplete allows you to choose the language and format for the country in question, e.g. Cyrillic script. This means that any mailings sent to foreign addresses will be in the appropriate format and language, reducing the likelihood of misspellings or causing offence.
My account credentials are visible in my website source code. Is this safe?
Your account details can be restricted to your specific URL. This means that even with code types where your details are visible, they are still safe and secure. Anyone attempting to use them from another site would have their requests rejected and you’d be alerted via email.
Do you provide development accounts to allow me to test my integration?
Yes we do, although we can’t provide unrestricted development accounts under the terms of our agreement with our data providers. However, within reason, we can provide you with free test credit for development purposes.
Common problems and errors
This installation cannot be used from this IP address, the security settings may not include this IP address
Within your installation settings you have the option to limit our service to only accept requests on that key that are coming from specified IP addresses. This is a security feature to prevent your key from being used anywhere other than where you intended. If you set this up and then get this error message it means an attempt has been made to use the service from another IP. The IP address will be detailed in the email.
This installation cannot be used from this website—the security settings may not include this domain
Within your installation settings you have the option to limit our service to only accept requests on that key that are coming from specified website addresses. This is a security feature to prevent your key from being used anywhere other than the site you intended. If you set this up and then get this error message it means an attempt has been made to use the service from another website. The website address will be detailed in the email.
The installation has reached its daily limit. Please check your settings or wait until tomorrow.
Each installation has a setting that dictates the total credit it can consume from the account on a single calendar day. This is a security setting to help protect your credit from being consumed too quickly. It can be changed by editing the installation in your dashboard.
Your credit has run out
This means your account has run out of credit. An ‘error message’ email will be generated when a user tries to do a lookup. Simply sign in to your account to add more credit.