FastSpring
This document provides a step-by-step guide to setting up an integration between your Zentitle2 account and FastSpring.
The integration between Zentitle2 and FastSpring is designed to provide a seamless experience for customers, from purchase to activation, in less than 10 seconds. The partnership between Nalpeiron's Zentitle2 and FastSpring unites world-class licensing and e-commerce for a powerful customer experience. The integration with FastSpring adds speed that simplifies the whole purchasing and licensing process.
Setup your Zentitle2 account
You need to contact your sales representative to enable the FastSpring integration. The configuration will be fully available after it is enabled.
On this page, you can see:
The Private Key - This is used for signing the payload sent between the two platforms
Integration Endpoint - The endpoint that is used to generate new license codes
TenantId - The account ID used in the integration
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FPsI8DhAMHuB9zFwy9AUJ%252Fimage%2520%284%29.png%3Falt%3Dmedia%26token%3Da5c2ddbc-21a9-4bee-a4bf-2e3d4be9fe90&width=768&dpr=4&quality=100&sign=153c24f0&sv=1)
You need to define your Private Key to be used later in the FastSpring Store interface.
The Integration Endpoint and TenantId will be required in the FastSpring Store setup.
Setting up FastSpring
The critical component of the integration is the Zentitle2 offering SKU, which must be set in the FastSpring Store. The integration uses the SKU sent from FastSpring to match the offering used to create the new entitlement.
In the Dashboard for your FastSpring Store, set up a license fulfillment action, which will issue a license on a non-subscription product.
From the Dashboard, select the Products menu.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FL0zXky2AZdNdAS1ZLbqS%252Fimage.png%3Falt%3Dmedia%26token%3D76646193-a3f8-434d-bf81-f43d7bbb2e3e&width=768&dpr=4&quality=100&sign=648d2ef8&sv=1)
Click the Products, Bundles, or Subscriptions tab, depending on the product for which you want to set up Nalpeiron integration.
Click the product, bundle, or subscription for which you want to set up Nalpeiron integration to open the product’s details.
In the product details, click ADD FULFILLMENT.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252Fx8fuWcraUmf0IJWf6sYq%252Fimage.png%3Falt%3Dmedia%26token%3D7591cb24-4ee4-4f11-b5b2-6539c920c9b4&width=768&dpr=4&quality=100&sign=94b76c8f&sv=1)
In the Add Fulfillment Action dialog, select Generate a License.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252F8TvNfKoTgerXOg7BzF4j%252Fimage.png%3Falt%3Dmedia%26token%3D8c977ef0-3731-4262-9d35-67a09d538dd3&width=768&dpr=4&quality=100&sign=2e15694&sv=1)
In the resulting drop-down list, select Remote Server Request.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252F4ndu6VHx6ChdlLQf1cc0%252Fimage.png%3Falt%3Dmedia%26token%3D7e4c2eed-3b83-416e-beb2-2172b6f0f230&width=768&dpr=4&quality=100&sign=b5ad4334&sv=1)
Click NEXT at the lower right-hand corner of the page.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FLJ4InI4uA80SQ3Oyn9Xe%252Fimage.png%3Falt%3Dmedia%26token%3D0e735d0c-fd21-4c6b-bbb6-d7799bc04d04&width=768&dpr=4&quality=100&sign=24d03ef0&sv=1)
Paste the Integration Endpoint copied from the Zentile2 platform in the URL field.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FBM19YPDLipVtzmQJeqfc%252Fimage.png%3Falt%3Dmedia%26token%3Dfd7596d6-a76a-405b-974e-70ca2478d561&width=768&dpr=4&quality=100&sign=c9680e49&sv=1)
Leave the rest of the fields as default and click CREATE.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252Fpf4l3YKEHBOuw7hf4wwS%252Fimage.png%3Falt%3Dmedia%26token%3D8984898c-6a97-45f1-92a5-10e447652f0b&width=768&dpr=4&quality=100&sign=f7cb1af1&sv=1)
Go to the Security tab and paste the Private Key copied from the Zentitle2 platform.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FOY8Fy7IKontt4azs1TQi%252Fimage.png%3Falt%3Dmedia%26token%3De391e5e4-7ee2-4852-bc74-e2364c992b9f&width=768&dpr=4&quality=100&sign=e7a6fdba&sv=1)
Go to the Parameters tab and use one of the custom values to create a new parameter.
a. Name: tenantId
b. Value: The Tenant ID copied from the Zentitle2 platform.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FNOxX7vxzy8p2EQ9nS9nV%252Fimage.png%3Falt%3Dmedia%26token%3D6e7e4d18-c65f-49e7-ac80-0b40be6c08b4&width=768&dpr=4&quality=100&sign=790ecce6&sv=1)
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FGYroKswzVipVaftmbRAO%252Fimage.png%3Falt%3Dmedia%26token%3D3537b12f-e476-45ef-8baf-f8b7d2a3dc51&width=768&dpr=4&quality=100&sign=471bd2ee&sv=1)
Press Save in the left corner of the screen.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252F4Q70c4Ckz6tn6gYuDWoi%252Fimage.png%3Falt%3Dmedia%26token%3D6029b81e-ffb4-4739-a53d-9052c9954f2d&width=768&dpr=4&quality=100&sign=b55af29b&sv=1)
To verify that the integration has been set up correctly, you can use the Test button.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FdqSmCampJG16ZixLr7tb%252Fimage.png%3Falt%3Dmedia%26token%3D52729295-0802-4421-97e1-9457f44915b6&width=768&dpr=4&quality=100&sign=c4c4b49b&sv=1)
The only field required for testing is the SKU.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252FKSOrmsH5ZoOYg8h1RxBf%252Fimage.png%3Falt%3Dmedia%26token%3D9792be48-e7c1-4e78-a353-f3f1dfe982f5&width=768&dpr=4&quality=100&sign=d0f9b305&sv=1)
Once you enter a valid SKU value, a message box will appear indicating that a license has been acquired, and an entitlement with this activation code will be created on the Zentitle2 platform.
![](https://docs.zentitle.io/~gitbook/image?url=https%3A%2F%2F2412542193-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1tBhTGn5igyI6ECLHjpC%252Fuploads%252F9PBbBCW7P1XIUbT8ZTJ1%252Fimage.png%3Falt%3Dmedia%26token%3D8e2bb5e1-d402-4fac-9f17-535d6ebe344a&width=768&dpr=4&quality=100&sign=3073c77d&sv=1)
This serves as proof that the integration has been successfully set up.
The above steps should be repeated for each product.
Last updated