Skip to main content

Paddle

Paddle is a popular platform for selling software and other digital goods. Here's a step-by-step guide to help you integrate Paddle with Mixpost Enterprise and get started with processing payments:

1. Sign up for a Paddle Account

  • Production: If you haven’t already, visit Paddle's website and sign up for an account.
  • Sandbox (only for testing): If you haven’t already, visit Paddle's sandbox website and sign up for an account.

We recommend integrating a Sandbox account first and testing the integration. If everything is fine, you can switch to a production Paddle account.

2. Access the Paddle Dashboard

Once you've registered, log in to your Paddle account and access the Dashboard. This will be your primary interface for managing payments.

3. Get Your API Keys

From the Dashboard:

  1. Go to the “Developer Tools” section.
  2. Click on "Authentication".
  3. You'll see Your Paddle Vendor ID. Copy it.
  4. Scroll down to the "Generate Auth Code" section and generate one.
  5. You will see your generated key and the "Reveal Auth Code" button. Click on it and copy the key.
  6. Go to the “Public Key” page (under the Developer Tools menu) and copy the entire Public Key

Note: Always keep your Secret Key confidential.

paddle-1.png

paddle-2.png

4. Integrate API Keys into Mixpost Enterprise

Once you have your API keys:

  1. Open the Enterprise Console from the user menu.
  2. Navigate to Settings ->
  3. Click on Paddle
  4. Choose "Enabled" radio input
  5. Input your Vendor ID, Vendor Auth Code, and Public Key.
  6. Select Sandbox (Yes) If you are in a Sandbox Paddle account.
  7. Save

paddle-3.png

paddle-4.png

5. Set Up Webhooks

Webhooks allow Paddle to communicate with Mixpost Enterprise when certain events happen (e.g., a successful payment, subscription changes, etc.).

  1. In your Paddle Dashboard, navigate to the "Developers" section.
  2. Click on "Events".
  3. Scroll down to the "URLs for receiving webhooks" section.
  4. Input Endpoint URL "https://your-app-url.com/mixpost/payment-webhook".
  5. Scroll down to the event's configuration and select Webhook for the following events:
    • Subscription Created
    • Subscription Updated
    • Subscription Cancelled
    • Subscription Payment Success
    • Subscription Payment Failed
  6. Save Changes

paddle-5.png

paddle-6.png

6. Add pricing plans

We are adding all the necessary pricing plans in both Paddle and Mixpost Enterprise.

  1. In your Paddle Dashboard, navigate to the "Catalog".
  2. Click on "Subscription Plans"
  3. Here, you'll see the “+ New Plan” button. Click on it.
  4. Give a plan name, for example: "Starter"
  5. Taxable Category, select "Standard Digital Goods"
  6. Select "Billing interval". Mixpost only accepts Monthly or Yearly billing periods.
  7. Scroll down to the "Subscription Plan Pricing" section
  8. Select the "Standard pricing" model.
  9. Input the default plan price, for example: "$9.00"
  10. Save plan

If you want to support Monthly and Yearly billing periods for plans, you should add the same Plan twice, first select "Billing Interval" under "Monthly" and then select "Yearly".

paddle-7.png

paddle-8.png

After the plans have been created in your Paddle dashboard. You should copy the Plan ID of each subscription plan to your created plans in the Mixpost Dashboard. See the instructions.

7. Test the Integration

  1. Try to register a user and subscribe to a plan.
  2. Use Paddle's test card numbers to make sure the subscription is done correctly.

8. Go Live

If you have integrated with your Paddle's sandbox account, and you're confident in the integration:

  1. Repeat the integration process for your Production Paddle account.
  2. Ensure you've added any necessary pricing plans in both Paddle and your Mixpost Enterprise console.
  3. Start onboarding users and generating revenue!

Back to top