> ## 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: Track Failed Payments

> Track when payments fail to process. Measure payment failure rate and revenue at risk.

<Tip>
  Payment Failed counts the number of payments that failed to process successfully.
</Tip>

## Formula

<Info>
  **Payment Failed** = **COUNT** ( payment\_failed events )
</Info>

### Formula Components

| Metric                     | Definition                                   |
| -------------------------- | -------------------------------------------- |
| **payment\_failed events** | Events fired when a payment fails to process |

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

***

## Example

Your application tracked **89 payment\_failed events** in January.

| Metric            | Value | Notes                |
| ----------------- | ----- | -------------------- |
| Payment Attempted | 2,245 | Total attempts       |
| Payment Failed    | 89    | Failed payments      |
| Failure Rate      | 4.0%  | Payment failure rate |

***

## How It Works

The Upstack pixel tracks `payment_failed` events when payment processing fails. This includes declined cards, insufficient funds, expired cards, and other payment errors.

***

## When to Use

| Scenario                  | Action                             |
| ------------------------- | ---------------------------------- |
| Payment health monitoring | Track failure rates over time      |
| Dunning optimization      | Identify failed payments for retry |
| Revenue recovery          | Prioritize recovery efforts        |
| Billing system analysis   | Diagnose payment processing issues |

***

## Related Metrics

| Metric                                                                             | Relationship                  |
| ---------------------------------------------------------------------------------- | ----------------------------- |
| [Payment Failed Cost](/reference/metrics/funnel/conversions/payment-failed-cost)   | Cost associated with failures |
| [Payment Failed Value](/reference/metrics/funnel/conversions/payment-failed-value) | Revenue at risk from failures |
| [Payment Succeeded](/reference/metrics/funnel/conversions/payment-succeeded)       | Successful payments           |

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