Using FastSpring

This tutorial will guide you through setting up FastSpring integration with Cryptlex for automated license management. It supports both one-time purchases and subscriptions. For subscriptions, it handles renewals, suspensions, and deletions based on the corresponding subscription events.

Prerequisites

1. Follow the Cryptlex quick start in the documentation.

2. Deployment of the integration script by either:

   • Self hosting: Follow the deployment guide to set up and configure the integration on your own infrastructure.

   • Cryptlex-hosted deployment: Opt for Cryptlex’s managed hosting service for a nominal fee.

Step 1: Configure FastSpring Products

• Go to the "Catalog" section in FastSpring dashboard.

• Add these custom attributes to your “Product” or “Subscription”:

  • cryptlex_product_id

  • cryptlex_license_template_id

For multiple products, ensure each has unique custom attributes.

Step 2: Set Up Webhooks

• Navigate to "Developer Tools" > "Webhooks" in FastSpring.

• Click "ADD WEBHOOK" and enable "webhook expansion".

• Configure the URL Endpoint by specifying the URL of the deployed integration script.

• Configure a secret in the HMAC SHA-256 Secret field. This secret must also be passed to the integration script to ensure secure verification of webhook requests.

• Configure the webhook to send specific or all available events, depending on your use case:

  • order.completed - Creates a new license.

  • subscription.charge.completed - Renews the associated license.

  • subscription.payment.overdue - Suspends the associated license.

  • subscription.deactivated - Deletes the license.

Next steps

After setup, the integration will:

• Generate new licenses automatically upon order completion. The license will have metadata with FastSpring order/subscription IDs.

• Handle subscription renewals, suspensions, and cancellations automatically.

• Create a user in Cryptlex using customer's email and name present in the checkout.

Need more help?

In case you need more help with using FastSpring, we'll be glad to help you make the integration. You can either post your questions on our support forum or contact us through email.