Troubleshooting

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.