The error codes listed below can help partners troubleshoot and resolve most problems. When additional help is needed from Elavon, reach out to Elavon Customer Support.
Common Errors
The error code is a required string with a format of AAA.XXXX.CCCC.
- AAA - HTTP status code
- XXXX - API Proxy Code
- CCCC - Error description code
Error Code |
Error Message |
Resolution Text |
---|---|---|
400.XXXX.4000 |
Invalid Request. |
Check API Reference and make sure the request is valid. |
400.XXXX.4100 |
Required field(s) missing. |
Some of the mandatory fields are missing in the request. Provide the missing data, then resubmit. |
400.XXXX.4101 |
Request field(s) exceeded max length/min length. |
See field length restrictions in API Reference and correct the field length. |
400.XXXX.4102 |
Request fields contain invalid characters. |
See the allowed characters for the field in API Reference and correct the field formatting. |
400.XXXX.4103 |
Field values incorrectly formatted. |
See the format of the field in API Reference and correct the field formatting. |
400.XXXX.4106 |
Required header(s) missing. |
Some of the headers are mandatory in the request. Check API Reference and provide mandatory headers. |
400.XXXX.4108 |
Invalid page size or page number. Page does not exist. |
Wrong or out of bounds page information is given in pagination fields. Verify that the correct values have been provided in the pageSize and pageNumber fields. |
400.XXXX.4109 |
Request is missing information required to complete this action. |
The application is missing some mandatory fields. Provide the minimum required data before resubmitting. |
400.XXXX.4110 |
Array Limit exceeded as per maxItems parameter. |
This field is an array and has a maximum limit. Check API Reference and adjust the number of items to an allowable amount. |
400.XXXX.4111 |
Invalid Field Value. |
This field accepts predefined field values. Check API Reference and provide the correct value. |
400.XXXX.4112 |
Invalid Header or Field name. |
See API Reference for valid headers and field names. |
400.XXXX.4113 |
Invalid Enum Value. |
This field accepts predefined enums. Check API Reference and provide the correct one. |
400.XXXX.4114 |
Invalid Request. |
Application is already being submitted, no changes can be made or updated at this time. |
400.XXXX.4115 |
Minimum one principal is required to complete an application. |
Add at least one applicant to the boarding application. |
400.XXXX.4116 |
Missing minimum required data on the application before you could add Person/Product/Bank Accounts. |
Refer to API Reference for minimum required fields and provide the missing data. |
400.XXXX.4117 |
Terminal not yet ready. |
The Terminal ID (TID) is not yet available. Typically, the TID is available within a few minutes after application approval. |
400.XXXX.4118 |
Application is not yet ready for document upload, please retry. |
Check to see if a previous document has successfully completed the upload process before attempting to upload another document. |
400.XXXX.4119 |
Application should be submitted prior to documents upload. |
Submit your application first, then attempt to upload any required documents. |
400.XXXX.4120 |
Maximum four persons can be added to an application. |
Remove any applicants that exceed the maximum limit of four, then resubmit. |
400.XXXX.4121 |
Field value should be minimum {@fieldvalue}. |
The numerical value entered doesn’t meet the minimum threshold. Refer to API Reference for valid field limits. |
400.XXXX.4122 |
Field value should be maximum {@fieldvalue}. |
The numerical value entered exceeds the maximum threshold. Refer to API Reference for valid field limits. |
400.XXXX.4123 |
Type must be submitted along with value. |
Include the missing field type. Refer to API Reference for valid values. |
400.XXXX.4124 |
addressType must be submitted. |
The addressType field must be provided (example: Business Address). Check API Reference for accepted address types. |
400.XXXX.4125 |
Both agreementSigner and primaryContact need to be set up either as 'true' or 'false'. |
Review these two fields and make sure that only one principal on the application is set as the agreementSigner/primaryContact. |
400.XXXX.4126 |
legalIdType must be submitted along with legalId. |
The legal ID and legal ID type refer to legal documentation belonging to an individual applicant. Provide the missing field data (e.g. SSN). Refer to API Reference for valid legal ID types. |
400.XXXX.4128 |
Sum of these fields should be exactly 100: cardPresentAcceptancePercent, cardNotPresentAcceptancePercent, internetAcceptancePercent. |
Update the values and make sure the fields add up to 100. |
400.XXXX.4129 |
The value should be greater/less than the min/max value provided. |
The numerical value entered doesn’t fall within the minimum and maximum values provided. Refer to API Reference for valid field limits. |
400.XXXX.4130 |
Only one of the Persons can be set up as agreementSigner and primaryContact. |
Review and make sure that only one person on the application is set as the agreementSigner/primaryContact. |
400.XXXX.4141 |
Person not found. |
The submitted information does not match with the records. Check the information the resubmit. |
400.XXXX.4142 |
MCC could not be found. |
Submit a valid MCC value. |
400.XXXX.4143 |
One of these fields are required at minimum - cardPresentAcceptancePercent, cardNotPresentAcceptancePercent, internetAcceptancePercent. |
At least one of the fields should have value passed through. |
400.XXXX.4144 |
Sum of these fields should be 100 - cardPresentAcceptancePercent, cardNotPresentAcceptancePercent, internetAcceptancePercent. |
Update the values and make sure the fields add up to 100. |
400.XXXX.4145 |
Query found too many results, please expand your search criteria. |
Expand the search criteria to narrow the query results. |
400.XXXX.4148 |
One of the values can be set to true. |
Check the values and make sure only one of them is set to true. |
400.XXXX.4149 |
The following addressType already exists on the account, multiple entries not allowed on the same addressType. |
Only one address is supported per address type. |
400.XXXX.4150 |
The following address cannot be updated, as the given addressType does not exist on the account. |
Check and submit the address again for a correct address type. |
400.XXXX.4151 |
Please review the latest terms of services before you submit your acceptance. |
Review the Terms and Conditions of Use. |
401.XXXX.4010 |
The request has not been applied because it lacks valid authentication credentials for the target resource. |
Authentication credentials are wrong. Recheck your authentication credentials. If you do not already have credentials, contact your Elavon Customer Service Representative. |
401.XXXX.4011 |
Invalid or expired API Key. |
API Key is expired, please recreate the token. |
403.XXXX.4030 |
The request has not been applied as access is forbidden for this user. |
User is not allowed to use the requested resource. Authorization failed. User may not have relationship with the customer location enterprise ID passed. |
403.XXXX.4032 |
The request has not been applied as access is forbidden for this user. |
User is not allowed to use the requested resource. Authorization failed. User may not have relationship with the customer location enterprise ID passed. |
404.XXXX.4040 |
The server has not found anything matching the request URI. |
Resource not found. Check portal documentation for the correct URL. |
404.XXXX.4041 |
The request version not supported. |
Version number is not correct. Check portal documentation for the correct versioning. |
405.XXXX.4050 |
The requested resource does not support HTTP method requested. |
HTTP method is not allowed. For example, you cannot POST on some of the resources. |
429.XXXX.4290 |
Too Many Requests. |
Too many requests came to server. |
500.XXXX.5000 |
Internal Server Error. |
Backend system error. Please contact support. |
500.XXXX.5010 |
Request exceeds the maximum range of {@range} records that can be retrieved from the server. |
Recheck the number of records requested to ensure it is a valid value. |
502.XXXX.5020 |
Backend Service Exception, Please call customer service. |
Backend system error. Please contact support. |
503.XXXX.5030 |
Service Temporarily Unavailable. |
Backend system error. Please contact support. |
504.XXXX.5040 |
Timeout Error. |
Backend system error. Please contact support. |