Skip to main content
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

FieldTypeRequiredDescription
providerstring❌Name or identifier of the provider where the failure occurred. Contact your Account Manager for an enumerated list of possible values.
attemptNumberinteger⚠️Sequential number of this attempt. At least one of attemptNumber or createdAt should be passed.
providerFailureCodestring✅Provider-specific failure or decline code
createdAtstring⚠️When the failure occurred (ISO 8601 date-time format). At least one of attemptNumber or createdAt should be passed.

​
Example

{
  "provider": "AcquirerX",
  "attemptNumber": 1,
  "providerFailureCode": "05",
  "createdAt": "2025-11-05T14:22:10Z"
}