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

# PreviousFailure

> Information about a previous failed payment attempt with another provider

The `PreviousFailure` object represents information about a previous failed payment attempt with another payment provider. This allows merchants to provide context about failed attempts when retrying payments, which can help improve approval rates.

## Properties

| Field                 | Type      | Required | Description                                                                                                                            |
| :-------------------- | :-------- | :------: | :------------------------------------------------------------------------------------------------------------------------------------- |
| `provider`            | `string`  |     ❌    | Name or identifier of the provider where the failure occurred. Contact your Account Manager for an enumerated list of possible values. |
| `attemptNumber`       | `integer` |    ⚠️    | Sequential number of this attempt. At least one of attemptNumber or createdAt should be passed.                                        |
| `providerFailureCode` | `string`  |     ✅    | Provider-specific failure or decline code                                                                                              |
| `createdAt`           | `string`  |    ⚠️    | When the failure occurred (ISO 8601 date-time format).  At least one of attemptNumber or createdAt should be passed.                   |

## Example

```json theme={null}
{
  "provider": "AcquirerX",
  "attemptNumber": 1,
  "providerFailureCode": "05",
  "createdAt": "2025-11-05T14:22:10Z"
}
```