# Payment recovery (Dunning)

### What is Payment Recovery?

Payment Recovery is an automated feature that helps you handle failed subscription payments by attempting to charge customers again after a payment failure. Instead of immediately canceling a subscription when a payment fails, this feature gives you control over when and how many times to retry the payment, significantly reducing subscription churn.

### Why use this feature

Payment Recovery helps you:

* **Reduce subscription churn** by automatically retrying failed payments
* **Recover lost revenue** from temporary payment issues like expired cards or insufficient funds
* **Improve customer retention** by giving customers more time to update their payment methods
* **Automate payment management** without manual intervention
* **Maintain customer relationships** by preventing unnecessary subscription cancellations

Common payment failures that this feature addresses include expired credit cards, insufficient funds, network timeouts, and temporary banking issues.

### How to use Payment recovery

{% embed url="<https://app.arcade.software/share/2GvEMvZv6PbICiFUq29X>" %}
Set up payment recovery
{% endembed %}

#### Step 1: Access Payment recovery settings

1. In the Joy Subscription dashboard, click **Settings** in the left sidebar
2. Select **Payment recovery** from the settings menu

The Payment recovery section will display with a toggle switch and configuration options.

#### Step 2: Enable and configure payment recovery

**Enable the Feature**

1. Toggle the **Payment recovery** switch to enable the feature
2. The status will change from off to on, and configuration fields will become available

**Configure Retry attempts**

1. In the **Maximum number of retry attempts** field, enter a number between 1 and 6

**Set Retry delay**

1. In the **Delay before retrying a failed payment** field, enter a number between 1 and 10 days

**Choose Final Action**

1. Click the **Action when maximum number of retry attempts reached** dropdown
2. Select your preferred action:
   * **Do nothing:** Marks the order as 'Billing failed' and continues with regular billing schedule
   * **Additional options include:** Cancel subscription or pause subscription

**Enable Email notifications**

1. Check the box for **Send an email if a billing retry attempt fails** if you want to notify customers about failed retry attempts
2. This helps keep customers informed and encourages them to update their payment information

### Summary

Payment Recovery is now configured to automatically handle failed subscription payments. The system will:

1. Attempt to retry failed payments based on your specified schedule
2. Send email notifications to customers (if enabled)
3. Take the configured action after maximum retry attempts are reached


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avada.io/joy-subscriptions/settings/payment-recovery-dunning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.