Using Paddle

This tutorial will guide you through setting up Paddle integration with Cryptlex for automated license management. It supports both one-time purchases and subscriptions. For subscriptions, it handles renewals, suspensions, and resumptions 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 support to request managed hosting.

Step 1: Set Up Product in Paddle

In your Paddle Dashboard:

  1. Navigate to Catalog > Products page and click on New Product. Follow the on-screen instructions for creating 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 in Cryptlex after a successful checkout.
    • subscription.paused - Triggers license suspension in Cryptlex when a subscription is paused.
    • subscription.resumed - Triggers allowing the license back in Cryptlex when a previously paused subscription is resumed.
    • subscription.canceled - Triggers license revocation in Cryptlex when a subscription is canceled in Paddle.

  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 have questions, need assistance, or experience any issues, please feel free to reach out to our support team at support@cryptlex.com.

Using StripeUsing Web API
Last updated: