Once you’ve created the app, you’ll be presented with your public API key and an HTML snippet. To install the widget simply copy the HTML snippet and place it just before the closing </body> tag on your website as seen below:
Once you have the snippet on your site, you should notice any input elements using the email type are automatically detected by the widget. If your field doesn’t use the
<input type="email" name="email_field" /> <input type="text" name="email_field" data-nb />
There are two types of Settings for your widget: security settings and behavior settings. Security settings are controlled from your dashboard where you initially setup the widget. View your existing widgets here. Behavior settings are controlled from the HTML snippet placed on your site.
Authorized domains and IP addresses prevent your public API key from being used from unauthorized sources. Requests made with your public API key are only accepted when they come from one of your authorized sources.
If you do not specify any authorized domains or IP addresses, all requests made with your key will be processed regardless of location.
Specifying throttling rules allow you to prevent users from abusing your forms. You can specify multiple rules to limit the number of verifications made in a given timeframe by IP or even globally across all IP addresses. When the limit is hit, the widget will treat the request as an unknown as not to block the transaction.
Not specifying throttling rules leave your widgets at risk for abuse. This may cause your credit balance to deplete or possible risk of account closure.
When you install the widget with the HTML snippet you may notice a line which reads _NBSettings. As you might suspect, this is where you specify the settings for the widget on your site. Initially, the snippet only includes the apiKey setting – this is the only setting needed to make the widget work. When more control is needed, the snippet below contains all the settings and their default values:
For more advanced customization of the widget go here for details.