Decline Recovery

View recoveries

Returns declined transactions within the given date range along with the decline recovery status of each.

For additional information about this endpoint, see the Retrieving transaction list from decline recovery tutorial.

<!-- theme: warning -->

⚠️ Try It

To use the Try It feature for this endpoint, you must use the credentials for your Sandbox API user.

<div style="display:none;">

Request parameters

  • endDate
  • limit
  • offset
  • startDate
  • recoveryStatus

Response parameters

  • offset
  • limit
  • rows
  • rows.id
  • rows.retryDate
  • rows.transactionDate
  • rows.originalAmount
  • rows.originalDeclinePaymentId
  • rows.orderNumber
  • rows.recoveryStatus
  • rows.retryCount
  • rows.merchantId
  • rows.userName
  • rows.isEnabledForRecovery
  • rows.declineMessage
  • rows.updatedAt
  • hasMore
</div>
get/recovery/v3

Query parameters

limitinteger
Example:12

Specifies the maximum number of transactions to return in a single API response. For example, if you set limit=20, the API returns up to 20 transactions starting from the position specified by the offset parameter.

offsetinteger
Example:10

Specifies the starting point within the list of transactions. Use it in conjunction with the limit parameter to control which subset of transactions the API returns. For example, if you set offset=10 and limit=20, the API skips the first 10 transactions and returns the next 20 transactions (in other words, transactions 11 to 30).

startDatestring
Example:2024-12-13

The start date. If you do not specify a value, the system uses the date 30 days prior to today's date. Format: YYYY-MM-DD

endDatestring
Example:2024-12-19

The end date. If you do not specify a value, the system uses today's date. Format: YYYY-MM-DD

recoveryStatusRecoveryStatus — unresolved $ref

The recovery status of the transaction. Possible values: - 10: Disabled- 20: In progress- 30: Scheduled- 40: Unrecoverable- 50: Recovered

Response

Success

offsetinteger

The number of rows by which the data is offset.

limitinteger

The limit of the number of rows.

hasMoreboolean

Will be true if there are more records not included in the current response.

Changes

No recorded changes to this endpoint across all 1 revision of this API.