Paddle

This guide walks you through integrating Paddle with Cryptlex for automated license management. The integration supports both one-time purchases and subscriptions. For subscriptions, it handles renewals, suspensions, and revocations 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 Paddle-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 Paddle

In your Paddle Dashboard:

  1. Navigate to Catalog -> Products and click New Product. Follow the on-screen instructions to create your desired product(s).
  2. Add the following custom attributes to your product:
    • cryptlex_license_template_id
    • cryptlex_product_id

Step 2: Configure webhooks

  1. In your Paddle Dashboard, go to Developer Tools -> Notifications.

  2. Click New Destination, and enter the URL where your integration script is hosted.

  3. Select the following events to listen for:

    • transaction.completed: Triggers license creation after a successful checkout.
    • subscription.paused: Triggers license suspension when a subscription is paused.
    • subscription.canceled: Triggers license revocation when a subscription is canceled in Paddle.
    • customer.created: Creates the corresponding user in Cryptlex.

  4. Retrieve the signing secret and provide it to your integration script for webhook verification.

What happens next

Once the integration is active:

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

Need more help?

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

StripeFastSpring
Last updated: