Prerequisites
Before connecting Paddle to Paymint, you need:- A Paddle Billing account (not Paddle Classic)
- Your Paddle account must be approved for payment processing
- Follow the first 4 steps of the Paddle Setup Checklist to ensure your account is properly configured.
Existing Paddle Accounts: Even if you already have an account, please confirm that your configuration matches the first 4 steps of the Paddle Setup Checklist.
Don’t have a Paddle account yet? Sign up at paddle.com — approval typically takes 1-2 business days.
Creating Your API Key
Log into Paddle Dashboard
Go to vendors.paddle.com and sign in to your Paddle Billing dashboard.Make sure you’re using Paddle Billing (not Paddle Classic). The URLs should start with
vendors.paddle.com.Navigate to Developer Tools → Authentication
In the left sidebar, expand Developer Tools and click Authentication.
Click '+ New API key'
On the Authentication page, click the + New API key button in the top-right corner.
Fill in the API Key Details
In the New API key dialog:
- Name — Give it a descriptive name (e.g.,
your-app-prod-paymint) - Description — Optional, but helpful (e.g.,
API key to be used by paymint.dev) - Expires at — Set to
Never expiresunless you have a rotation policy - Permissions — Select All → Read & Write for full access
Copy Your API Key
After saving, Paddle will show your generated API key.
pdl_live_ (production) or pdl_sdbx_ (sandbox).Connecting to Paymint
Open Paddle Configuration
In the Paymint dashboard, go to Settings → Paddle Configuration.If you’re a new user, you’ll be redirected here automatically after sign-up.
Automatic Provisioning
Paymint will automatically:
- API Key Stored — Validates and securely stores your key
- Client Token Created — Generates a frontend-safe token for Paddle.js
- Webhook Created — Sets up real-time event processing
- Products Synced — Imports your products and prices from Paddle
Creating Products and Prices
Before starting the SDK integration, you need to have products and prices defined. If you haven’t already created products and prices in your Paddle dashboard, you can use Paymint’s Product & Price UI to create them directly. Paymint will then automatically sync these to your Paddle account.What Paymint Provisions Automatically
Once you enter your API key, Paymint handles the following automatically:| Feature | Description |
|---|---|
| Client Token | A frontend-safe token for Paddle.js checkout integration |
| Webhook Endpoint | Receives real-time events (subscriptions, payments, etc.) from Paddle |
| Product Sync | Imports your products and prices (up to 20 products with 30 prices each) |
Troubleshooting
”Invalid API Key Format”
Make sure your key starts withpdl_. If you copied it from Paddle Classic (not Paddle Billing), it won’t work.