How to recover failed Paddle payments
By the ChurnLeak team · Updated
The short answer
To recover failed Paddle payments, check that Paddle's own payment recovery is on, then find every subscription that is past due, look at why each payment failed, and send each customer the link where they update their card. Paddle retries a failed renewal and, with Retain, emails the customer for you, so the main jobs left are seeing the total at risk, catching cards before they expire and making sure only one set of emails goes out.
What happens when a Paddle renewal fails
When Paddle can't collect an automatic renewal, the transaction and its subscription become past due. The customer keeps access while Paddle tries to collect, and the subscription only changes for good when recovery runs out.
- Paddle retries the payment on its own over a period of about 30 days.
- If Retain payment recovery is on, Paddle also emails the customer during that time, asking them to update their payment details. Retain works on live accounts, not the sandbox.
- When recovery runs out, Paddle pauses or cancels the subscription, depending on your settings.
- Invoices you send for manual collection work differently: they go past due after the due date and are not retried, so the customer has to pay them.
Check your own Paddle settings for the exact behaviour on your account. The point is that most failed renewals are card problems, not customers who want to leave, so most can be won back.
Why Paddle payments fail
Each failed payment attempt on a transaction carries an error code. It tells you whether a retry might work or the customer has to act.
| Error code | What it means | What fixes it |
|---|---|---|
| insufficient_funds | Not enough money on the card right now | A retry a few days later often works |
| expired_card | The card on file has expired | The customer adds a new card |
| declined | The bank refused without a reason | A retry, then the customer |
| authentication_failed | The customer didn't complete 3D Secure | The customer confirms the payment |
| invalid_card, invalid_payment_details | The card details are wrong | The customer adds a new card |
| lost_card, stolen_card, blocked_card | The card was blocked | The customer adds a new card |
Retrying a card that is expired or reported stolen will never work, so those customers need a clear email with a link to update their card.
Step 1: Check Paddle's own recovery settings
Start with what Paddle already does for free. In your Paddle dashboard, look at the Retain settings for payment recovery.
- Check whether Retain payment recovery emails are on. If they are, Paddle is already emailing customers whose renewal failed.
- Choose what happens when recovery runs out: pause the subscription or cancel it. Pausing keeps the customer's plan, so they can come back by updating their card.
- Set up the customer portal (Checkout, then Customer portal), so customers can update their card on their own at any time.
Step 2: Find every past due payment and add it up
Paddle shows past due transactions one by one, but not one total of the money at risk. Filter Transactions by Past due to see them, or use a tool that reads them for you.
ChurnLeak reads your Paddle account with an API key that has read permissions only (Customers, Subscriptions and Transactions). In about two minutes it shows every past due renewal, the cards that expire before their next renewal, and the total money at risk. The audit is free.
Step 3: Email customers a direct link to update their card
A good recovery email is short and has one button. Every Paddle subscription has its own link for updating the payment method, so the customer goes straight to the right page without logging in anywhere.
- Send it in your product's name, with replies going to a real person.
- Say what failed and how much, in one sentence. Don't blame the customer.
- Link to the subscription's update payment method page, or your Paddle customer portal.
- Stop the moment the payment succeeds. A Paddle webhook (Developer tools, then Notifications) makes that instant.
Step 4: Make sure customers get one set of emails, not two
If Paddle Retain already emails your customers, a second tool emailing the same people in the same week feels like spam. Pick one sender:
- Let Paddle send the emails, and use ChurnLeak for the audit, expiring cards, the dashboard and Slack alerts, with ChurnLeak's recovery emails turned off.
- Turn Retain's payment recovery emails off and let ChurnLeak send them, in your product's name, with your own schedule and wording on Pro and Growth.
Step 5: Catch expiring cards before they fail
The cheapest failed payment is the one that never happens. ChurnLeak reads the expiry date of the card used for each subscription's last payment, and emails the customer before a card expires ahead of its next renewal.
Get told about new failed payments as they happen with Slack alerts, so a big customer never slips through.
What to automate
ChurnLeak has a free audit, then Starter at $4.99/month, Pro at $9.99/month and Growth at $19.99/month, each with a 7-day free trial, no MRR limit and no cut of what you recover. It works with Paddle Billing and Stripe, and it never charges, refunds or changes anything in your account.
Already on Stripe instead? Read how to recover failed Stripe payments.
Common questions
Does Paddle retry failed payments automatically?
Yes. For automatically collected renewals, Paddle retries the payment over about 30 days while the subscription is past due. Invoices for manual collection are not retried.
Does ChurnLeak work with Paddle Classic?
No. ChurnLeak uses the Paddle Billing API, so it needs a Paddle Billing account and an API key that starts with pdl_live_apikey_ (or pdl_sdbx_apikey_ for the sandbox).
Can ChurnLeak change anything in my Paddle account?
No. Give the key read permission for Customers, Subscriptions and Transactions only. ChurnLeak reads billing data and sends emails; it never charges, refunds or changes a subscription.
Will my customers get emails from both Paddle and ChurnLeak?
Only if both are on. If Paddle Retain sends payment recovery emails for you, either turn ChurnLeak's recovery emails off and use it for the audit and alerts, or turn Retain's emails off and let ChurnLeak send them.
See what failed payments cost you.
Connect a read-only Stripe or Paddle key and get a dollar total in two minutes. Free, no card needed.