{"openapi":"3.0.0","info":{"title":"Financial Adjustments","version":"1.0.1","contact":{"name":"Fiserv EMEA Developer Portal","url":"https://fiserv.dev/support","email":"support@20080132.hubspot-inbox.com"},"description":"Welcome to Experience Financial Adjustments API. \r\nThis API enables acquirers and payment facilitators to submit fees and adjustments to merchant accounts to be considered on the merchant payment or collection."},"servers":[{"url":"https://prod.emea.api.fiservapps.com/sandbox/exp/v1/financial/adjustments/","description":"Sandbox"},{"url":"https://prod.emea.api.fiservapps.com/exp/v1/financial/adjustments/","description":"Production"}],"paths":{"/post-adjustment":{"post":{"summary":"Create an Adjustment","description":"Submit fees and adjustments to merchant accounts to be considered on the merchant payment or collection.","operationId":"post-adjustment","parameters":[{"$ref":"#/components/parameters/Message-Signature"},{"$ref":"#/components/parameters/Institution-Number"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Adjustment"}}}},"responses":{"201":{"description":"Financial Adjustment Successfully entered.","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for each API request which can be used for diagnosing issues and corresponding with support.","required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdjustmentResponse"},"examples":{"createAnAdjustmentResponse":{"value":{"adjustmentSlipNumber":"12345678901","adjustmentStatus":"Entered","adjustmentCreatedDate":20240130}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/AuthenticationError"},"403":{"$ref":"#/components/responses/AccessForbidden"},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Endpoints"],"security":[{"Api-Key":[]}]}},"/modify-adjustment":{"put":{"summary":"Modify an Adjustment","description":"Modify an adjustment that has been created. Modifying adjustment is allowed only prior to it is picked up for processing i.e. modify an adjustment is allowed if the status of adjustment is NOT in 'Released' and 'Cancelled'. Single adjustment modification per API call is allowed.","operationId":"modify-adjustment","parameters":[{"$ref":"#/components/parameters/Message-Signature"},{"$ref":"#/components/parameters/Institution-Number"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModifyAdjustment"}}}},"responses":{"204":{"description":"Financial Adjustment Modified Successfully.","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for each API request which can be used for diagnosing issues and corresponding with support.","required":true}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/AuthenticationError"},"403":{"$ref":"#/components/responses/AccessForbidden"},"404":{"$ref":"#/components/responses/ResourceNotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Endpoints"],"security":[{"Api-Key":[]}]}},"/cancel-adjustment":{"delete":{"summary":"Cancel an Adjustment","description":"Cancel an adjustment. Cancelling an adjustment is allowed only prior to it is picked up for processing i.e. cancel an adjustment is allowed if the status of adjustment is NOT in 'Released' and 'Cancelled'. One adjustment cancellation per API call is allowed.","operationId":"cancel-adjustment","parameters":[{"$ref":"#/components/parameters/Message-Signature"},{"$ref":"#/components/parameters/Institution-Number"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelAdjustment"}}}},"responses":{"204":{"description":"Financial Adjustment Successfully cancelled.","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for each API request which can be used for diagnosing issues and corresponding with support.","required":true}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/AuthenticationError"},"403":{"$ref":"#/components/responses/AccessForbidden"},"404":{"$ref":"#/components/responses/ResourceNotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Endpoints"],"security":[{"Api-Key":[]}]}},"/get-adjustments-staged":{"get":{"summary":"Retrieve Adjustments","description":"Retrieve list of adjustments that are stagged.","operationId":"get-adjustments","parameters":[{"$ref":"#/components/parameters/Institution-Number"},{"$ref":"#/components/parameters/AdjustmentSlipNumber"},{"$ref":"#/components/parameters/BatchSlipNumber"},{"$ref":"#/components/parameters/MerchantId"},{"$ref":"#/components/parameters/AdjustmentStatus"},{"$ref":"#/components/parameters/AdjustmentCategory"},{"$ref":"#/components/parameters/AdjustmentType"},{"$ref":"#/components/parameters/dateFrom"},{"$ref":"#/components/parameters/dateTo"},{"$ref":"#/components/parameters/LimitParam"},{"$ref":"#/components/parameters/OffsetParam"}],"responses":{"200":{"description":"Success","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for each API request which can be used for diagnosing issues and corresponding with support.","required":true}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseType"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GetAdjustments"}}},"required":["data"]}]},"examples":{"OK":{"value":{"meta":{"paging":{"count":100,"totalPages":10,"currentOffset":1,"currentNumberOfRetrievedRecords":2,"maxLimit":2,"hasMoreRecords":true,"pageNumber":1},"sorting":{"sort":"name,-startDate"}},"data":[{"merchantId":"23456789","adjustmentSlipNumber":"12345678901","adjustmentStatus":"ENTERED","adjustmentCategory":"ADJUSTMENT","adjustmentType":{"index":"839","description":"Misc Merchant CR"},"adjustmentCreationDate":"20240424","accountNumber":"90000001001","amount":"100.12","currency":"EUR","date":"20240424","description":"Chargeback Fee CR","feeSequence":{"Code":"M09","description":"CLRG WRT OFF FEES"},"originalTransactionArn":"93240548754263421094323","quantity":"10","batchSlipNumber":"12345678999","createdBy":"Financial_Adjustment_API"},{"merchantId":"23456789","adjustmentSlipNumber":"12345458910","adjustmentStatus":"ENTERED","adjustmentCategory":"ADJUSTMENT","adjustmentType":{"index":"840","description":"Misc Merchant DR"},"adjustmentCreationDate":"20240425","accountNumber":"90000001002","amount":"10.12","currency":"EUR","date":"20240425","description":"Chargeback Fee DR","feeSequence":{"Code":"M09","description":"CLRG WRT OFF FEES"},"originalTransactionArn":"93240548754263421091113","quantity":"2","batchSlipNumber":"12345678119","createdBy":"Financial_Adjustment_API"}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/AuthenticationError"},"403":{"$ref":"#/components/responses/AccessForbidden"},"404":{"$ref":"#/components/responses/ResourceNotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Endpoints"],"security":[{"Api-Key":[]}]}},"/reference-data":{"get":{"summary":"Retrieve Reference Data","description":"Returns a list of valid values for the requested classification for an institution.","operationId":"get-reference-data","parameters":[{"$ref":"#/components/parameters/Institution-Number"},{"name":"classification","schema":{"type":"string","enum":["adjustmentTypeIndex","feeSequenceCode","adjustmentStatusIndex"]},"in":"query","description":"This parameter can be used to filter the result for a particular classification. If ommited no filtering is done and all classifications with the corresponding values are extracted."}],"responses":{"200":{"description":"Success","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for each API request which can be used for diagnosing issues and corresponding with support.","required":true}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ResponseType"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/referenceDataRecord"}}}}]},"examples":{"multiplelist":{"value":{"meta":{"paging":{"count":6,"totalPages":1,"currentOffset":0,"currentNumberOfRetrievedRecords":6,"hasMoreRecords":false,"pageNumber":1},"sorting":{"sort":"classification,code"}},"data":[{"classification ":"adjustmentTypeIndex","code":"839","description":"Misc Merchant CR"},{"classification ":"adjustmentTypeIndex","id":"840","description":"Misc Merchant DR"},{"classification ":"feeSequenceCode","code":"M09","description":"CLRG WRT OFF FEES"},{"classification ":"feeSequenceCode","code":"T09","description":"Trmnl NOT returned"},{"classification ":"adjustmentStatusIndex","code":"001","description":"Entered"},{"classification ":"adjustmentStatusIndex","code":8,"description":"Released"}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/AuthenticationError"},"403":{"$ref":"#/components/responses/AccessForbidden"},"404":{"$ref":"#/components/responses/ResourceNotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"tags":["Endpoints"],"security":[{"Api-Key":[]}]}}},"components":{"securitySchemes":{"Api-Key":{"name":"Api-Key","type":"apiKey","in":"header","description":"Your API key from the Developer Platform."}},"responses":{"BadRequest":{"description":"Bad request","headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for this request which can be used for diagnosing issues and corresponding with support."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"Badrequest":{"value":{"errors":[{"title":"Bad Request - Incorrect or Missing Field","detail":"There is a validation error with fieldName. Field in body is mandatory. Please fix and repeat your request.","source":"fieldName"}]}}}}}},"AuthenticationError":{"description":"Unauthorised","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"Unauthorised":{"value":{"errors":[{"title":"Authentication Error","detail":"No valid API key or credential has been provided in the request."}]}}}}},"headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for this request which can be used for diagnosing issues and corresponding with support."}}},"AccessForbidden":{"description":"AccessForbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"Forbidden":{"value":{"errors":[{"title":"Forbidden error","detail":"Access to the requested resource is forbidden."}]}}}}},"headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for this request which can be used for diagnosing issues and corresponding with support."}}},"ResourceNotFound":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"Notfound":{"value":{"errors":[{"title":"Resource Not Found","detail":"The requested resource cannot be found."}]}}}}},"headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for this request which can be used for diagnosing issues and corresponding with support."}}},"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"Internalservererror":"value:one wrong at our end. If this persists please contact support and provide the value of your Trace-Id header."}}},"headers":{"Trace-Id":{"schema":{"type":"string"},"description":"An internal unique ID for this request which can be used for diagnosing issues and corresponding with support."}}}},"schemas":{"Adjustment":{"description":"Content for Creating Adjustments.","type":"object","properties":{"adjustmentCategory":{"type":"string","description":"Indicates 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. To enable consumer usage, the adjustment category must be defined for an institution.","enum":["CHARGES_FEES","ADJUSTMENT"],"example":"ADJUSTMENT"},"adjustmentTypeIndex":{"maxLength":3,"minLength":3,"pattern":"^[0-9]{3,3}$","type":"string","description":"Index of the adjustment transaction type under respective adjustment category 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\".","example":"839"},"merchantId":{"description":"Unique OmniPay 8-digit internal merchant number assigned to the merchant where the adjustment should be posted to. Creating adjustment to a merchant is permitted as long as the merchant is in an active status.","maxLength":8,"minLength":8,"pattern":"^[0-9]{8,8}$","type":"string","example":"23456789"},"accountNumber":{"description":"Unique internal account number linked to the merchant account and account currency assigned to the merchant where the adjustment is posted to. Creating adjustment to a merchant account is permitted as long as the account is in an active status. If provided, the adjustment will be posted to this merchant account. If not provided, the adjustment will be posted to the respective merchant account and account currency based on the posting instructions configured to the merchant. For list of valid values, use GET accounts endpoint in Merchant Maintenance API.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","type":"string","example":"90000001001"},"amount":{"description":"Adjustment amount. The amount must be greater than zero. The maximum allowed number of decimal places should align with the precision set for the 'currency' configured within OmniPay.","maxLength":18,"minLength":0,"pattern":"^[0-9\\.]{0,18}$","type":"string","example":"100.12"},"currency":{"description":"Currency of the adjustment amount. ISO 4217 Alpha Currency code. Note that if the currency of the adjustment amount provided differs from the currency of the merchant account it is posted to, currency conversion will be conducted (at the time of end of cycle posting process) based on the FX rate rules established at the institution level.","maxLength":3,"minLength":3,"pattern":"^[a-zA-Z]{3,3}$","type":"string","example":"EUR"},"date":{"description":"Indicates the transaction date related to the adjustment made. Format YYYYMMDD. The date must not exceed the current system date.","maxLength":8,"minLength":8,"pattern":"^([0-9]{4})(-?)(1[0-2]|0[1-9])\\2(3[01]|0[1-9]|[12][0-9])$","type":"string","example":"20240424"},"description":{"type":"string","description":"Adjustment description. If the first 2 characters are passed as “##”, the description will be suffixed in the “Transaction Type” field in reporting. There is no pattern defined for this field. UTF8 characters (extended ASCII characters) are supported for this field. Maximum length of this field is defined in bytes and special character of any extended ASCII character can be more than 1 byte for each character. Consumer should consider number of bytes for maximum length determination. For example, if consume wants to provide three 2-bytes ASCII character, then actual length of the provided data is 6, not 3.","minLength":0,"maxLength":25,"example":"Chargeback Fee CR"},"feeSequenceCode":{"description":"Fee sequence code that will be linked to the adjustment. For a list of valid values, use Financial Adjustment API GET reference-data endpoint with query parameter \"classification\" equal to \"feeSequenceCode\".","maxLength":3,"minLength":3,"pattern":"^[0-9A-Z]{3}$","type":"string","example":"0Z1"},"originalTransactionArn":{"type":"string","pattern":"^[0-9]{23}$","description":"Acquirer reference number linked to the Original transaction. For certain acquirers, this field is required if the provided fee sequence code is linked to chargebacks.","minLength":23,"maxLength":23,"example":"93240548754263421094323"},"quantity":{"type":"string","description":"Represents the count or quantity of transactions that are involved in the adjustment.","maxLength":6,"minLength":0,"pattern":"^[0-9]{0,6}$","example":"10"}},"required":["adjustmentCategory","adjustmentTypeIndex","merchantId","amount","currency","date"]},"ModifyAdjustment":{"description":"Content for modifying an Adjustment.","type":"object","properties":{"adjustmentSlipNumber":{"type":"string","description":"Unique slip number generated for the adjustment.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"},"adjustmentCategory":{"type":"string","description":"Indicates 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. To enable consumer usage, the adjustment category must be defined for an institution.","enum":["CHARGES_FEES","ADJUSTMENT"],"example":"ADJUSTMENT"},"adjustmentTypeIndex":{"maxLength":3,"minLength":3,"pattern":"^[0-9]{3,3}$","type":"string","description":"Index of the adjustment transaction type under respective adjustment category 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\".","example":"839"},"merchantId":{"description":"Unique OmniPay 8-digit internal merchant number assigned to the merchant where the adjustment should be posted to. Modifying adjustment to a merchant is permitted as long as the merchant is in an active status.","maxLength":8,"minLength":8,"pattern":"^[0-9]{8,8}$","type":"string","example":"23456789"},"accountNumber":{"description":"Unique internal account number linked to the merchant account and account currency assigned to the merchant where the adjustment is posted to. Modifying adjustment to a merchant account is permitted as long as the account is in an active status. If provided, the adjustment will be posted to this merchant account. If not provided, the adjustment will be posted to the respective merchant account and account currency based on the posting instructions configured to the merchant. For list of valid values, use GET accounts endpoint in Merchant Maintenance API.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","type":"string","example":"90000001001"},"amount":{"description":"Adjustment amount. The amount must be greater than zero. The maximum allowed number of decimal places should align with the precision set for the 'currency' configured within OmniPay.","maxLength":18,"minLength":0,"pattern":"^[0-9\\.]{0,18}$","type":"string","example":"100.12"},"currency":{"description":"Currency of the adjustment amount. ISO 4217 Alpha Currency code. Note that if the currency of the adjustment amount provided differs from the currency of the merchant account it is posted to, currency conversion will be conducted (at the time of end of cycle posting process) based on the FX rate rules established at the institution level.","maxLength":3,"minLength":3,"pattern":"^[a-zA-Z]{3,3}$","type":"string","example":"EUR"},"date":{"description":"Indicates the transaction date related to the adjustment made. Format YYYYMMDD. The date must not exceed the current system date.","maxLength":8,"minLength":8,"pattern":"^([0-9]{4})(-?)(1[0-2]|0[1-9])\\2(3[01]|0[1-9]|[12][0-9])$","type":"string","example":"20240424"},"description":{"type":"string","description":"Adjustment description. If the first 2 characters are passed as “##”, the description will be suffixed in the “Transaction Type” field in reporting. There is no pattern defined for this field. UTF8 characters (extended ASCII characters) are supported for this field. Maximum length of this field is defined in bytes and special character of any extended ASCII character can be more than 1 byte for each character. Consumer should consider number of bytes for maximum length determination. For example, if consume wants to provide three 2-bytes ASCII character, then actual length of the provided data is 6, not 3.","minLength":0,"maxLength":25,"example":"Chargeback Fee CR"},"feeSequenceCode":{"description":"Fee sequence code that will be linked to the adjustment. For a list of valid values, use Financial Adjustment API GET reference-data endpoint with query parameter \"classification\" equal to \"adjustmentTypeIndex\".","maxLength":3,"minLength":3,"pattern":"^[0-9A-Z]{3}$","type":"string","example":"0Z1"},"originalTransactionArn":{"type":"string","pattern":"^[0-9]{23}$","description":"Acquirer reference number linked to the Original transaction. For certain acquirers, this field is required if the provided fee sequence code is linked to chargebacks.","minLength":23,"maxLength":23,"example":"93240548754263421094323"},"quantity":{"type":"string","description":"Represents the count or quantity of transactions that are involved in the adjustment.","maxLength":6,"minLength":0,"pattern":"^[0-9]{0,6}$","example":"10"}},"required":["adjustmentSlipNumber"]},"CancelAdjustment":{"description":"Content for cancelling an Adjustment.","type":"object","properties":{"adjustmentSlipNumber":{"type":"string","description":"Unique slip number generated for the adjustment.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"}},"required":["adjustmentSlipNumber"]},"AdjustmentResponse":{"title":"Adjustments Response","type":"object","properties":{"adjustmentSlipNumber":{"type":"string","description":"Unique slip number generated for the adjustment.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"},"adjustmentStatus":{"type":"string","description":"Status of the adjustment.","minLength":0,"maxLength":23,"example":"Entered"},"adjustmentCreationDate":{"description":"Indicates the date that the adjustment is created. Format YYYYMMDD.","maxLength":8,"minLength":8,"pattern":"^([0-9]{4})(-?)(1[0-2]|0[1-9])\\2(3[01]|0[1-9]|[12][0-9])$","type":"string","example":"20240424"}}},"GetAdjustments":{"title":"Get Adjustments","type":"object","properties":{"merchantId":{"description":"Unique OmniPay 8-digit internal merchant number assigned to the merchant where the adjustment is posted.","maxLength":8,"minLength":8,"pattern":"^[0-9]{8,8}$","type":"string","example":"23456789"},"adjustmentSlipNumber":{"type":"string","description":"Unique slip number generated for the adjustment.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"},"adjustmentStatus":{"type":"string","description":"Status of the adjustment.","minLength":0,"maxLength":23,"example":"ENTERED"},"adjustmentCategory":{"type":"string","description":"Indicates 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.","enum":["CHARGES_FEES","ADJUSTMENT"],"example":"ADJUSTMENT"},"adjustmentType":{"type":"object","description":"Adjustment transaction type used to post the adjustment to merchant account and can be used to track in reporting.","properties":{"index":{"maxLength":3,"minLength":3,"pattern":"^[0-9]{3,3}$","type":"string","description":"Index of the adjustment transaction type.","example":"839"},"description":{"type":"string","description":"Description of the adjustment transaction type.","minLength":0,"maxLength":100,"example":"Misc Merchant CR"}}},"adjustmentCreationDate":{"description":"Indicates the date that the adjustment is created. Format YYYYMMDD.","maxLength":8,"minLength":8,"pattern":"^([0-9]{4})(-?)(1[0-2]|0[1-9])\\2(3[01]|0[1-9]|[12][0-9])$","type":"string","example":"20240424"},"accountNumber":{"description":"Unique internal account number linked to the merchant account and account currency assigned to the merchant where the adjustment is posted.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","type":"string","example":"90000001001"},"amount":{"description":"Adjustment amount.","maxLength":18,"minLength":0,"pattern":"^[0-9\\.]{0,18}$","type":"string","example":"100.12"},"currency":{"description":"Currency of the adjustment amount. ISO 4217 Alpha Currency code.","maxLength":3,"minLength":3,"pattern":"^[a-zA-Z]{3,3}$","type":"string","example":"EUR"},"date":{"description":"Indicates the transaction date related to the adjustment made. Format YYYYMMDD.","maxLength":8,"minLength":8,"pattern":"^([0-9]{4})(-?)(1[0-2]|0[1-9])\\2(3[01]|0[1-9]|[12][0-9])$","type":"string","example":"20240424"},"description":{"type":"string","description":"Adjustment description.","minLength":0,"maxLength":25,"example":"Chargeback Fee CR"},"feeSequence":{"type":"object","description":"Fee Sequence that is linked to the adjustment.","properties":{"Code":{"description":"Fee sequence code.","maxLength":3,"minLength":3,"pattern":"^[0-9A-Z]{3}$","type":"string","example":"M09"},"description":{"type":"string","description":"Description of the fee sequence code.","minLength":0,"maxLength":100,"example":"CLRG WRT OFF FEES"}}},"originalTransactionArn":{"type":"string","pattern":"^[0-9]{23}$","description":"Acquirer reference number linked to the Original transaction.","minLength":23,"maxLength":23,"example":"93240548754263421094323"},"quantity":{"type":"string","description":"Represents the count or quantity of transactions that are involved in the adjustment.","maxLength":6,"minLength":0,"pattern":"^[0-9]{0,6}$","example":"10"},"batchSlipNumber":{"type":"string","description":"Unique slip number generated for the batch where the adjustment is grouped.","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678999"},"createdBy":{"description":"Source channel used to create or modify or cancel the adjustment.","example":"Financial_Adjustment_API","maxLength":60,"minLength":0,"pattern":"^[a-zA-Z0-9À-ý_ \\.\\&\\,]{0,60}$","type":"string"}}},"Error":{"description":"This is the generic Error Response to be used for all Errors sent back in responses.","type":"object","title":"Error Response","properties":{"errors":{"type":"array","uniqueItems":false,"items":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string","description":"Readable error message that could be displayed in a UI."},"detail":{"type":"string","description":"Further description provided to give wider context into the error."},"source":{"type":"string","description":"Optional: Known source of error such as missing or invalid field in a request."}},"required":["title","detail"]}}},"required":["errors"]},"referenceDataRecord":{"type":"object","properties":{"classification":{"type":"string","example":"adjustmentTypeIndex","enum":["adjustmentTypeIndex","feeSequenceCode","adjustmentStatusIndex"],"minLength":1,"maxLength":20,"description":"The value of the classification match the index field for which the list of codes is applicable. "},"code":{"maxLength":8,"minLength":1,"pattern":"^[0-9A-Z]{1,8}$","type":"string","description":"Index/Code value."},"description":{"maxLength":100,"minLength":0,"type":"string","description":"Contains description associated to a code/index in English."}},"title":"Reference Data Record","description":"The classification makes reference to a field. The code is the valid value for the field. The description is the meaning of the code."},"ErrorType":{"description":"Message details - additional operation execution information.","type":"object","properties":{"id":{"description":"Generated message identifier for particular request, helping to locate server logs.","example":"dd4ba13c-4a3c-4078-a31f-35ac9c07a8f7","type":"string"},"code":{"description":"Machine readable, unique code of the message related to particular case within operation execution. For complete list of codes please refer to API portal, messages page.","example":"ACCOUNT_NUMBER_NOT_FOUND","type":"string"},"title":{"description":"Short description of the error. Not for displaying purposes.","example":"The authorization credentials required for this request are invalid.","type":"string"},"detail":{"description":"Provides additional low-level details about the error to assist with troubleshooting. Not for displaying purposes.","example":"SQLException found while trying to establish the connection with table TUKCDHN.","type":"string"},"source":{"$ref":"#/components/schemas/SourceType"}},"required":["code","title"]},"LinksType":{"description":"Contains the links to retrieve the resources exposed as part of this API.","type":"object","properties":{"self":{"description":"The link to the primary resource being retrieved in the request.","example":"https://api.firstdata.com/ipp/accounts-management/v1/accounts?offset=3&limit=10","type":"string"},"first":{"description":"This is to provide the link to retrieve the first record/page. This SHOULD be used in case server provides pagination of the resource.","example":"https://api.firstdata.com/ipp/accounts-management/v1/accounts?offset=1&limit=10","type":"string"},"last":{"description":"This is to provide the link to retrieve the last record/page. This SHOULD be used in case server provides pagination of the resource.","example":"https://api.firstdata.com/ipp/accounts-management/v1/accounts?offset=10&limit=10","type":"string"},"prev":{"description":"This is to provide the link to retrieve the previous record/page. This SHOULD be used in case server provides pagination of the resource.","example":"https://api.firstdata.com/ipp/accounts-management/v1/accounts?offset=2&limit=10","type":"string"},"next":{"description":"This is to provide the link to retrieve the last record. This SHOULD be used in case server provides pagination of the resource","example":"https://api.firstdata.com/ipp/accounts-management/v1/accounts?offset=4&limit=10","type":"string"}},"title":"LinksType"},"MetaType":{"description":"Supplementary information about the data.","type":"object","title":"MetaType","properties":{"paging":{"$ref":"#/components/schemas/PagingMetaType"},"sorting":{"$ref":"#/components/schemas/SortingMetaType"},"messages":{"description":"Messages related to request processing or response data - any additional information or warnings to be returned in the case of a successful API call.","type":"array","items":{"$ref":"#/components/schemas/ErrorType"}}}},"PagingMetaType":{"description":"Map containing pagination related information about data.","type":"object","properties":{"count":{"description":"Total number of records present in system which can be retrieved.","example":100,"type":"integer"},"totalPages":{"description":"Total number of pages with maximum limit taken into account.","example":10,"type":"integer"},"currentOffset":{"description":"Current offset used in request.","example":1,"type":"integer"},"currentNumberOfRetrievedRecords":{"description":"Current number of retrieved records.","example":10,"type":"integer"},"maxLimit":{"description":"Maximum limit of records that can be retrieved.","example":10,"type":"integer"},"hasMoreRecords":{"description":"Indicates if there are more records available.","example":true,"type":"boolean"},"pageNumber":{"description":"Current page number.","example":1,"type":"integer"}},"title":"PagingMetaType"},"ResponseType":{"description":"An API response.\nThe API response will be either a `SUCCESS` or an `ERROR`. A partial success or warning scenario will be treated as a Success with embedded messages in the meta data. A full success may not have messages.\nThe API response will contain at least one of the following top level members.\"\n","type":"object","title":"ResponseType","x-examples":{},"properties":{"meta":{"$ref":"#/components/schemas/MetaType"},"data":{"description":"\"Contains the primary data to be returned as the API response. \n Use this object only when respnse type is an array.\nIt will not be returned in case of error.\"\n","type":"array","items":{"type":"object"}},"errors":{"description":"\"Contains one or more error messages and is mutually exclusive with the data item.\nThis will not be returned in success scenarios.\"\n","type":"array","items":{"$ref":"#/components/schemas/ErrorType"}},"links":{"$ref":"#/components/schemas/LinksType"}}},"SortingMetaType":{"description":"Map containing sorting related information about data.","type":"object","properties":{"sort":{"description":"Indicates the elements the current data is sorted with and the direction of sorting.","example":"name,-startDate","type":"string"}},"title":"SortingMetaType"},"SourceType":{"description":"Object containing references to the source of the message.","type":"object","properties":{"pointer":{"description":"Indicates the element in the request document which caused the error.","example":"/dogs/name","type":"string"},"parameter":{"description":"Indicates which query parameter caused the error.","example":"type","type":"string"},"header":{"description":"Indicates which header caused the error.","example":"type","type":"string"}},"title":"SourceType"}},"parameters":{"dateFrom":{"name":"dateFrom","in":"query","description":"Common data object to pass the from date value when fetching records for a given date range. Accepted format YYYY-MM-DD.  This parameter can be used in Path or Query.","required":false,"style":"form","explode":false,"schema":{"type":"string","format":"date","example":"2019-06-30"}},"dateTo":{"name":"dateTo","in":"query","description":"Common data object to pass the to date value when fetching records for a given date range. Accepted format YYYY-MM-DD. This parameter can be used in Path or Query.","required":false,"style":"form","explode":false,"schema":{"type":"string","format":"date","example":"2019-06-30"}},"AdjustmentSlipNumber":{"name":"adjustmentSlipNumber","in":"query","description":"Unique identifier of the individual adjustment.","required":false,"schema":{"type":"string","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"}},"BatchSlipNumber":{"name":"batchSlipNumber","in":"query","description":"Unique identifier of the individual batch that has list of adjustments grouped.","required":false,"schema":{"type":"string","maxLength":11,"minLength":11,"pattern":"^[0-9]{11}$","example":"12345678901"}},"AdjustmentCategory":{"name":"adjustmentCategory","in":"query","description":"Indicates 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.","required":false,"schema":{"type":"string","enum":["CHARGES_FEES","ADJUSTMENT"],"example":"ADJUSTMENT"}},"AdjustmentType":{"name":"adjustmentTypeIndex","in":"query","description":"Index 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\".","required":false,"schema":{"maxLength":3,"minLength":3,"pattern":"^[0-9]{3,3}$","type":"string","example":"839"}},"MerchantId":{"name":"merchantId","in":"query","description":"Unique OmniPay 8-digit internal merchant number assigned to the merchant where the adjustment is posted to.","required":false,"schema":{"maxLength":8,"minLength":8,"pattern":"^[0-9]{8,8}$","type":"string","example":"23456789"}},"AdjustmentStatus":{"name":"adjustmentStatus","in":"query","description":"Status 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\".","required":false,"schema":{"type":"string","maxLength":3,"minLength":3,"pattern":"^[0-9]{3}$","example":"001"}},"OffsetParam":{"name":"offset","in":"query","required":false,"schema":{"type":"integer","format":"int32","minimum":0,"default":0},"description":"The number of items to skip before returning the results."},"LimitParam":{"in":"query","name":"limit","required":false,"schema":{"type":"integer","format":"int32","minimum":1,"maximum":1000,"default":100},"description":"The number of items to return."},"Institution-Number":{"name":"Institution-Number","in":"header","schema":{"type":"string","maxLength":8,"minLength":8,"pattern":"^[0-9]{8,8}$","example":99},"required":false,"description":"Institution number (8-digit number) associated with the merchant. This information defines the acquirer for the merchant. If a consumer is granted access to this API for multiple institutions, this field must be populated. If access is for only one institution, the API will automatically determine this value, making it optional for the client."},"Message-Signature":{"name":"Message-Signature","in":"header","required":true,"schema":{"type":"string"},"description":"Optional security header. Used to ensure the request has not been tampered with during transmission. The Message-Signature is the Base64 encoded HMAC hash (SHA256 algorithm with the API Secret as the key.) For more information, refer to the supporting documentation on the Developer Portal."}}},"tags":[{"name":"Endpoints"}],"x-readme":{"explorer-enabled":true,"proxy-enabled":true}}