Getting Started

Getting applications integrated with TrialKey is usually a very quick process. TrialKey strives to make integration as simple and minimalistic as possible. How you integrate TrialKey depends on your application type and your licensing model.

If your application is a web site or mobile app where a single user has a single license, then your setup can be as simple as a single line of code. First, log into TrialKey and go to the Profiles section and fill in the Owns Domain field as well the information on the Company tab. This information is needed in order to use TrialKey properly.

Next, create your product by going to the Products section and creating a Product that has a LICWB type. Set the Default Trial Days you would like a new user to have, and then save the product.

Next, switch to the Profile section and the Quick Links tab and use the Account Signup URL, Login URL, and the Forgot Password URL on each the tabs to embed in your application or web pages to allow your users to sign up as a user for your application and manage their account. You can click each of these links to see your branded version of these pages, which is exactly what your users will see and use. If you have filled out and saved your profile information, you will see a branded version of these pages with your logo. For Android, iPhone or other mobile apps you can have users click a link in your app that opens a web page to these links to have them sign up. TrialKey includes re-captcha to protect your application and the platform from mis-use.

And that's it, you are set have new trial users sign up!

When a new user signs up for your application using the Account Signup URL, TrialKey will take the user through an email confirmation process exactly like the one used when you signed up for TrialKey. Once they have confirmed their account via the link within the email they receive, they can then log into your application in one of two ways, via the Account Login URL, or using the DoLogin() API from within your application.

If you use the Account Signup URL link, be sure that you have set the Login Success URL to where you would like a user to be re-directed to if their login is successful. When a user is redirected to the URL you specify, it will also include an AuthToken query parameter with the newly signed on user's token. When your application receives this redirect (it must be a server side script), use the GetAuthTokenUser() call to verify that the token represents an authenticated user and at the same time get that users name. At this point you should save or add a record for this user in your own database/persistent storage if you need to save user settings.