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
gatewaystring❌Name or identifier of the provider where the failure occurred
attemptNumberinteger❌Sequential number of this attempt
responseCodestring❌Provider-specific failure or decline code
reasonstring❌Human-readable reason for the failure
timestampstring❌When the failure occurred (ISO 8601 date-time format)
transactionIdstring❌Transaction identifier from the original provider
additionalDataobject❌Additional gateway-specific data as flexible key/value pairs. You can include any provider-specific information that may be relevant (e.g., AVS result, CVV result, custom fields)

​
Example

{
  "gateway": "AcquirerX",
  "attemptNumber": 1,
  "responseCode": "05",
  "reason": "Do not honour",
  "timestamp": "2025-11-05T14:22:10Z",
  "transactionId": "txn_abc123",
  "additionalData": {
    "avsResult": "N",
    "cvvResult": "N"
  }
}