> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upstackdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Failed Value: Revenue at Risk from Failed Payments

> Track the monetary value of failed payments. Measure revenue at risk for recovery.

<Tip>
  Payment Failed Value totals the revenue at risk from failed payments.
</Tip>

## Formula

<Info>
  **Payment Failed Value** = **SUM** ( value ) **FROM** payment\_failed events
</Info>

### Formula Components

| Metric                     | Definition                                 |
| -------------------------- | ------------------------------------------ |
| **value**                  | The monetary amount of each failed payment |
| **payment\_failed events** | Events fired when payments fail            |

| Metadata        |                         |
| --------------- | ----------------------- |
| **Type**        | Currency                |
| **Data Source** | [Upstack Pixel](/pixel) |
| **Aggregation** | Sum                     |

***

## Example

You had **89 failed payments** in January with an average value of **\$52**.

| Metric               | Value   | Notes                 |
| -------------------- | ------- | --------------------- |
| Payment Failed       | 89      | Failed payments       |
| Avg Failed Value     | \$52    | Average failed amount |
| Payment Failed Value | \$4,628 | Revenue at risk       |

***

## How It Works

This metric sums the value attribute from all payment\_failed events. The value represents revenue that was not collected due to payment failures, highlighting the potential recovery opportunity.

***

## When to Use

| Scenario              | Action                                       |
| --------------------- | -------------------------------------------- |
| Revenue recovery      | Prioritize dunning based on failed value     |
| Churn prevention      | High-value failures need immediate attention |
| Billing optimization  | Quantify impact of payment issues            |
| Financial forecasting | Factor failed payments into projections      |

***

## Related Metrics

| Metric                                                                                   | Relationship                 |
| ---------------------------------------------------------------------------------------- | ---------------------------- |
| [Payment Failed](/reference/metrics/funnel/conversions/payment-failed)                   | Count of failed payments     |
| [Payment Failed Cost](/reference/metrics/funnel/conversions/payment-failed-cost)         | CAC associated with failures |
| [Payment Succeeded Value](/reference/metrics/funnel/conversions/payment-succeeded-value) | Collected revenue            |

[See all Conversions metrics →](/reference/metrics/funnel/conversions)