Skip to main content
Start selling

Integrate Freemius Billing and Monetization with Claude Code

In this guide, you will learn how to set up Claude Code to integrate Freemius monetization, checkout, entitlements, and customer portal features into your SaaS product.

Preparation​

  1. Register through the Freemius Developer Dashboard and create a product.
  2. Follow our plans and pricing documentation to configure your plans, prices, and plan features.
  3. Open the project that you want Claude Code to update.

Install Freemius Skills​

Claude Code does not support the standard .agents directory. From the project root, install the skills specifically for Claude Code:

npx skills add freemius/freemius-ai -a claude-code

Install all the Freemius skills when prompted to get the complete checkout, entitlement, and customer portal workflow.

Set Your Freemius API Key​

On the Settings → API & Keys page, copy the .env file under Usage examples and save it in your project root.

Protect Your API Keys

Never commit the .env file to your repository. Store production credentials in your deployment platform's secrets manager.

Prompt Your First Integration​

Prompt Claude Code with a brief description of how you want to integrate Freemius and gate premium features behind a paywall. For example:

prompt
Integrate Freemius monetization into my software. I want to offer subscriptions with multiple plans for continued access and top-up plans for purchasing additional credits. Use the relevant Freemius skills. The .env file already contains the secrets needed to connect to the Freemius platform. You can query the Freemius API directly with the Freemius JS SDK to find the pricing IDs of the relevant plans. First inspect the existing application and propose an integration plan. After I approve the plan, implement it and run the relevant tests.

Claude Code will use the installed skills and your Freemius product configuration to implement the relevant pricing table, checkout, entitlements, top-up credits, and customer portal features. It may also create or update a top-level AGENTS.md file with instructions for maintaining the integration.

Plan Before You Prompt

For a complex product setup, first ask Claude Code to inspect your codebase and plan the integration without making changes. Review the proposed architecture, especially the authentication, entitlement storage, webhook handling, and checkout flow, before asking it to implement the plan.

Explain whether you sell subscriptions, top-up credits, or both. Also mention whether a user can hold more than one subscription and where premium access must be enforced.

Complete the Dashboard Setup​

After implementing the integration, Claude Code may ask you to configure URLs in the Freemius Developer Dashboard:

  • Go to Settings → Checkout & Redirection to configure the post-checkout redirection URL.
  • Go to Settings → Webhooks to add the webhook endpoint created for your application.

Use the exact URLs and events that Claude Code reports for your implementation.

Test the Integration​

Claude Code should adapt the Freemius integration to your application's existing structure. Verify that it created or updated the following features:

  1. Pricing Table: A pricing experience that displays the plans, prices, billing cycles, and features configured for your Freemius product.

  2. Checkout: A purchase flow that opens Freemius Checkout with the selected plan and returns the user to your application after a successful purchase.

  3. Entitlements and Paywalls: Backend and frontend checks that protect premium features, show a paywall to users without access, and grant access after the appropriate entitlement is received.

  4. Account Page and Customer Portal: An added or updated account area that displays relevant subscription or purchase information and gives users access to the Freemius Customer Portal.

Test these features with users who have and do not have active entitlements. Also verify that checkout redirection and webhook events update access and account information correctly.

Troubleshooting and Updates​

If the integration does not work as expected, describe the observed and expected behavior and ask Claude Code to use the freemius-troubleshooting skill. Before troubleshooting, update the installed skills:

npx skills update -y

For more information, examples, and best practices, see the Freemius Skills documentation.

On this page: