Paymend API documentation

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

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

API documentation

Endpoints

API Objects

PreviousFailure

Properties

Example

​Properties

​Example

Properties

Example