FastSpring

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

Prerequisites

  1. Complete the Cryptlex Quick Start Guide to set up your product and license templates.
  2. Deploy the FastSpring-Cryptlex integration script using one of the following options:
    • Self-hosted: Follow our deployment guide to run the integration on your infrastructure.
    • Cryptlex-hosted: Let Cryptlex host the integration for a nominal fee. Contact us through the contact page to request managed hosting.

Step 1: Set up products in FastSpring

  1. Go to the Catalog section in FastSpring.
  2. Add the following custom attributes to your product or subscription:
    • cryptlex_product_id
    • cryptlex_license_template_id
    • cryptlex_license_subscription_interval (optional): overrides the subscription interval defined in the license template.

Step 2: Configure webhooks

  1. In FastSpring, go to Developer Tools -> Webhooks.
  2. Click ADD WEBHOOK and enable webhook expansion.
  3. Set the URL endpoint to the URL where your integration script is hosted.
  4. Configure a secret in the HMAC SHA-256 Secret field and provide it to your integration script for webhook verification.
  5. 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 associated license.

What happens next

Once the integration is active:

  • New licenses are automatically created after successful FastSpring payments.
  • New users are created in Cryptlex using the customer's name and email from FastSpring, and are automatically linked to the corresponding license.
  • Licenses are automatically renewed in Cryptlex when the corresponding FastSpring subscription renews.

Need more help?

If you need help with the FastSpring integration, contact us through the contact page.

PaddleZapier
Last updated: