Paddle

Set up Paddle as your payment provider in Zellify

Setup Guide

Follow these steps to set up Paddle as your payment provider:

Access Paddle Dashboard

Navigate to Paddle Developer Tools and log in to your account.

Get API Credentials

Copy your API key from the Authentication section:

pdl_live_apikey_***

Configure Client Token

Copy your client-side token:

live_***

Save in Zellify Dashboard

  1. Go to Dashboard -> Settings -> Payment Provider

  2. Select "Paddle" as your provider

  3. Paste your API key and client token

  4. Save changes

Keep your API credentials secure and never expose them in client-side code or public repositories.

Payment Options & Checkout Configuration

Domain Approval

Submit your checkout domain for approval Example: onboarding.website.com

Checkout URL

Configure your checkout redirect URL Set your funnel domain URL

Apple Pay Integration

Apple Pay increases conversion rates by up to 2x with one-tap payments

Enable Apple Pay

Turn on Apple Pay in your Paddle dashboard Enable one-tap payments for iOS users

Domain Verification

Verify your domain for inline Apple Pay Upload association file to your domain

Checkout Theme

Match your funnels visual style:

Light Mode

Best for light-themed funnels Clean, bright checkout experience

Dark Mode

Best for dark-themed funnels Sleek, modern checkout experience

Webhook Configuration

Webhooks enable real-time notifications for payment events. Configure them to keep your application in sync with payment status changes.

Access Webhook Settings

Go to Paddle Notifications in your dashboard.

Add Webhook URL

Configure this endpoint in your Paddle dashboard:

https://staging-api.zellify.app/v1/webhook/paddle/:orgId

Replace :orgId with your organization ID. This URL could be found in the settings page of your organization.

Set Webhook Secret

Copy and securely store your webhook secret:

pdl_ntfset_***

Configure Events

Enable these webhook events:

  • transaction.created

  • transaction.updated

  • subscription.created

  • subscription.updated

Webhook events are delivered in near real-time. Implement proper error handling and retry logic in your webhook handler.

Common Issues & Solutions

Unable to load Paddle Configuration

Troubleshooting Steps

  1. Verify API key format and validity

  2. Check if the key has proper permissions

  3. Ensure you're using the correct environment (test/live)

  4. Clear browser cache and reload

Webhook events not received

Common Causes

  • Incorrect webhook URL

  • Missing event subscriptions

  • Network/firewall issues

  • Invalid webhook secret

Test your webhook endpoint using Paddle's webhook tester tool.

Payment processing errors

  1. Check payment provider dashboard for error details

  2. Verify customer billing information

  3. Ensure currency is supported

  4. Contact support if issues persist

External Resources

PreviousStripeNextStripe + RevenueCat

Last updated