List adjustments

Retrieve a list of financial adjustments that are staged by making a GET API call to /get-adjustments-staged endpoint in Financial Adjustment API.

User will be able to retrieve data up to 6 months in the past via API. For more than 6 months older data, please reach out to OmniPay Client Support to retreive data.

User will be able to filter the financial adjustments using following query parameters by passing in API request for every GET API call to /get-adjustments-staged endpoint:

OBJECTDESCRIPTION
adjustmentCategoryIndicates the category of the adjustment i.e. specifies that the category is used to identify whether the adjustment is related to charges/fees or if it is a generic adjustment. If the query parameter is not provided, the API will include adjustments linked to both of these categories in the response.
adjustmenSlipNumberUnique identifier of the individual adjustment.
adjustmentStatusStatus of the created adjustment. For a list of valid values, use Financial Adjustment API GET reference-data endpoint with query parameter "classification" equal to "adjustmentStatusIndex".
adjustmentTypeIndexIndex of the adjustment transaction type used to post the adjustment to merchant account and can be used to track in reporting. For a list of valid values, use Financial Adjustment API GET reference-data endpoint with query parameter "classification" equal to "adjustmentTypeIndex".
batchSlipNumberUnique identifier of the individual batch that has list of adjustments grouped.
merchantIdUnique OmniPay 8-digit internal merchant number assigned to the merchant where the adjustment should be posted to.
dateFromCommon data object to pass the from date value when fetching records for a given date range. Accepted format YYYY-MM-DD. The date entered should not exceed the current institution posting date. The date entered should fall within the last 6 months from the current institution posting date. The provided value should not be greater than the 'dateTo' field. If both the 'dateFrom' and 'dateTo' fields are provided, the date range should not exceed 1 month. If either the 'dateFrom' or 'dateTo' field is provided, data will be extracted for that specific day only. If neither of the 'dateFrom' and 'dateTo' fields provided, data will be extracted for current institution posting date.
dateToCommon data object to pass the to date value when fetching records for a given date range. Accepted format YYYY-MM-DD. The date entered should not exceed the current institution posting date. The date entered should fall within the last 6 months from the current institution posting date. The provided value should not be less than the 'dateFrom' field. If both the 'dateFrom' and 'dateTo' fields are provided, the date range should not exceed 1 month. If either the 'dateFrom' or 'dateTo' field is provided, data will be extracted for that specific day only. If neither of the 'dateFrom' and 'dateTo' fields provided, data will be extracted for current institution posting date.
limitThe number of items to return. Refer 'Guidance on Responses' section to know how to use this field.
offsetThe number of items to skip before returning the results. Refer 'Guidance on Responses' section to know how to use this field.

API Flow


Want a quick overview?