Company Formation White Label System - Technical Specification

	Contact Us
	Resources
	Products and services

Home - Company Formation - White Label System - White Label Technical Specification

White Label System
Technical Specification

Click here to download this document in Word Format >>

Overview

The Company Wizard white label system is a portable version of our acclaimed company formation software. The white label system can be deployed in any third party website and can incorporate your own unique branding to provide an interface for your end users to form a UK limited company with the look and feel of your website.

We have designed the system to be flexible yet easy to integrate with your existing website. You also have complete control of your retail prices and margins and can opt to sell a number of add on products such as company seals, name plates and registers.

Prerequisites

You will need the following prerequisites to use the system:

A website
A basic reseller account with us.
A method of taking payment from your customers (e.g. Payment service provider, cheque, or BACS).
A basic understanding of HTML to integrate the system into your website. We can provide assistance here where necessary although we may charge an integration fee depending on the work involved.

Implementation

There are effectively 3 stages to setting up the White Label system on your website.

Application

Once you have registered as a reseller from the following link you can apply for a White Label account.

http://www.company-wizard.co.uk/eiw/resellers.aspx

When completing your application you will be asked to provide two urls which point to your header and footer branding. If you haven’t designed your header and footer banners yet, don’t worry they can be added later.

You will also need to provide us with an email address and signature, this will enable use to customise any system emails we send to your end user and make them appear as if they are coming from your company not ours.

Once you have completed your initial application we will review the details and contact you within 24 hours.

Integration

The White Label system actually runs on our servers while dynamically rendering the pages with your own unique header and footer branding. In order for the system to function correctly it must be called in the correct way. There are several ways to call the system.

1.) A call is made by your website by linking to either the register or login page, your unique account number is passed in the querystring, this allows us to configure your branding. If a call is made to the register page then you must also pass the package identifier in the querystring (See appendix A).

2.) The end user progresses through the application running on our server. When the end user has completed all the relevant areas he/she will confirm the details and a postback will be made to a predetermined url on your server or directly into your Payment Service Provider (PSP). The postback delivers a number of variables in a HTTP post, these include the total amount and products/service ordered (For a full list see appendix B).

3.) The page on your server will catch the variables and perform any secondary processes (e.g. to calculate VAT) at this stage you will ordinarily show the total amount payable to the customer and finalise payment using your own chosen method. When payment has been authorised and you would like us to process the incorporation, you must make a post to a page on our server to indicate this (See appendix C). The system will only flag your company for processing if there are available funds in your account to allow for this otherwise you will receive an error code.

Product Selection

The White Label system provides you with the flexibility to choose exactly what products you would like to sell and the exact price you would like to sell them for. You can easily generate significant revenues on the White Label system by setting the right retail price from within your control panel. The following products are available for you to promote on the White Label system:

Printed memorandum & articles

Printed certificate of incorporation

Combined company register

Company seal

First board minutes template

Director’s service agreement

Employment contract pack

Brass name plate

Pricing

The White Label System is completely free to setup and there are no reoccurring charges to use the system. You simply pay as you go.

You can easily view the trade price of any package or product on our website by accessing your White Label control panel and clicking on ‘Integration Settings’.

When you register you will be provided with an account that you must top up whenever you have company incorporations to process. When you have built up some trading history with us you may be entitled to an extended credit limit.

Final points

If you have any difficulty integrating or using the White Label system please don’t hesitate to contact us on 01792 455916

----------------------------------------------------------------------------------------------------

Appendix A (Calling the White Label System)

Calling the White Label System simply involves formulating the correct link and redirecting the user to the system. The link must either invoke the register page or the login page.

New registration

Below is an example of a link that could be used to register a new company:

http://www.wls1.co.uk/wls/register.aspx?acc=10000000&uT=reg01

You will notice that two variables are being passed to the page in the querystring. These are as follows:

Acc – this denotes your reseller account number and is used to render your header and footer branding.

uT – This denotes the package that the end user would like to select the package options are as follows:

Package name	ID to pass
Basic	reg01
Standard	reg02
Executive	reg03
Limited by Guarantee	reg04

Ordinarily you would have 4 separate links from your site for each package option.

Existing login

Below is an example of a link that would be used to login a returning browser:

http://www.wls1.co.uk/wls/login.aspx?acc=10000000

Only the acc variable is passed to this page. The acc variable is used to configure the header and footer branding.

------------------------------------------------------------------------------------------------------

Appendix B (Handling the postback)

The postback occurs when all the required information for the company formation has been collected on our server. Essentially the postback will send a number of variables back to your server or directly into a predetermined payment gateway (e.g. PayPal) thus enabling you to collect payment from the end user.

The url or payment where the variables are posted to is defined in your White Label integration settings. Below are the variables that are posted to this url:

ID – a unique numeric ID for the company
yourAccount – your reseller account number
userAccount – your end users account number
packID – the package selected
companyName – the name of the company the end user wishes to form
orderStr – a string value containing a sequence of letters relating to what additional products have been ordered.
applicantName – the name of the end user
applicantEmail – the email address of the end user
applicantTel – the telephone number of the end user
orderTotal – the total value of the order (excluding vat if applicable)

The majority of these variables are self explanatory however to decode the orderStr variable you must use the following key:

A – Bound memorandum and articles
B – Printed certificate of incorporation
C – Company register
D – Company seal
E – First board minutes
F – Director’s service agreement
G – Employment contract pack
H – Brass name plate
K – Registered Office Service

For example if the value is BDH then the customer has ordered a printed certificate, company seal, and brass name plate.

-----------------------------------------------------------------------------------------------------

Appendix C

Once you have authorised payment for a company application you must then tell us that it is ready to be processed and sent off to Companies House. This can be done manually from within your Control Panel or you can use the automated post method detailed below.

To use the automated post method you will need to submit three form variables to the following url:

http://www.wls1.co.uk/wls/postLive.aspx

ID – the unique numeric ID for the company
accNumber – the end users account number
returnUrl – the url where you would like the browser to be send once the update has been made.

If any of these variables are not supplied, of the incorrect format or do not match an account in the database then the page will fail and deliver an error code in the querystring back to your returnUrl. This will also occur if you have insufficient funds in your White Label account.

The error code is delivered in a variable called ‘error’ and will be either one of the following:

01 = Company not found, or incorrect status.
02 = Supplied variables are not in the correct format
03 = One or more of the variables are missing
04 = Insufficient funds
05 = Duplicate or unrecognised account

Company Formation - Secretarial Software - Employment Contracts - Company Seals - Company Registration Pack -
Limited by Guarantee - Confidentiality Agreement - Sitemap - Terms of use - Privacy