Payment failure

Configuration guide for creating a payment failure flow. It details how to set up targeted in-app prompts to help users update their payment information and reduce involuntary churn.

Payment failures are a common cause of involuntary churn. This guide walks you through building a customer journey that gently prompts users to update their payment information, so you can recover failed charges and retain subscribers.
Available on all Recurly plans

Prerequisites

  • You must have Company, App Administrator, or App Member permissions in Recurly Engage.

Definition

Payment failures are a common issue for subscription businesses, and often lead to involuntary churn. This guide walks you through setting up a customer journey that gently prompts users to update their payment information, helping you recover failed charges and retain subscribers.

Key benefits

Increased recovery Guide users directly to where they can update their payment info, increasing the odds of recovering failed charges.
Customer-friendly Remind customers about a failed payment through targeted prompts — more effective and more user-friendly than silent, behind-the-scenes retries.
Actionable insights Test different messages and designs to see which ones are most effective at getting users to update their payment details.

Key details

A common problem for subscription businesses is a failed billing attempt — often caused by expired cards, fraud checks, or spending limits. Your payment processor may run some black-box recovery processes of its own, but only a small percentage of failures get resolved that way.

Recurly Engage adds another layer of protection against involuntary churn: a guide that prompts the user, over one or more visits, to update their payment information.

ImportantEnable the Sync events option, if your billing platform supports it, under Settings > Actions. This keeps dunning updates synced with your Recurly Engage segments.

Guide

1

Confirm your access

Make sure you're an active Recurly Engage user with Company, App Administrator, or App Member permissions.

Book a demo →

2

Log in to Recurly Engage

Access the Recurly Engage management console — known as Pulse — via Login. Pulse is your central interface for configuring applications, user traits, segments, prompts, guides, and integrations.

3

Create a Payment Failure Guide

This guide is a multi-step journey to re-engage customers with a failed payment.

  1. Go to Guides in the main navigation.
  2. Select the pre-configured Payment Failure Guide.
4

Review the guide data

The pre-configured guide opens to a dashboard showing its Segments, Limits, Status, Schedule, and any Daypart settings, plus a chart of Users, Clicks, and Conversion Rate. Edit these to fit your customized guide.

ImportantIf you connect Recurly Engage to Recurly, the Failed Payment segment is created automatically.
5

Set up your prompt

Select a prompt from the guide.

6

Add your trigger

In the Details section, set your trigger — the page or button on your site where the prompt fires. We recommend showing the Payment Failure prompt on every page except Billing Information, so users who click the prompt's CTA and land on Billing Information don't see the same prompt again. Configure a trigger for each prompt in the guide.

7

Set your actions

In the Actions section, set an action to trigger a customized flow based on the user's input — for example, redirecting users to the billing information page to update their payment.

8

Edit your design

From the Details screen, click Edit prompt design to open the prompt customization window.

Customize the title, message, size, and styling to fit your messaging — make sure the message is clear and compelling, and configure the prompt for both Desktop & Mobile.

If you'd like, adjust the prompt's visibility settings in the User Interaction section to show it again after specific button clicks within your guide.

9

Repeat steps 5–8 for additional prompts

Additional prompts might present the actions tied to a user's response. Users need to interact with step 1 before they see step 2, so set up a trigger for each prompt in the guide — for example, selecting "Too expensive" could surface a follow-up "Price - Save offer" prompt that needs its own design and configuration. Be sure to set criteria for when the guide should continue or exit.

For involuntary churn, you can set a custom goal that requires the user to take an additional action — like updating their payment method — to recover their account. The primary button click gets recorded, but the conversion event (the redirect) is the metric that matters. You can configure an exit event to fire once that custom goal is met.

10

Preview, test, and launch

After customizing your prompt, click Live Preview to see how the design appears on your site. Live Preview doesn't test the actual flows.

Test the flow on Live: add your own user ID to the Test Users segment under Settings > Users > Test Users.

Add Test Users to the guide: add Test Users as the segment so only test users see the prompt.

Reset clicks during testing: if you need to relaunch the guide while testing, reset the user's clicks under Settings > Users > Test Users > Reset Clicks.

Use the built-in preview tool: alternatively, use the Preview Tool in the Live Preview section and set the user ID to the one you want to test.

Once you're satisfied with your flow, remember to update your segments to target live users instead of test users, then set your guide's status to Live.

Estimate your savings

Every churn is lost revenue — and this flow can help you get it back.

Losing users isn't just a number, it's a direct hit to your bottom line. If you're losing 1,000 users a month at $10 each, that's $10,000 in lost revenue every month.

Recovering even a fraction of that can make a real difference to your business. By proactively re-engaging users, you can recover meaningful revenue and build a more sustainable subscriber base.

Want to see how you could turn churned users into recovered revenue?

Book a quick demo →


What’s Next

Did this page help you?