Choose the Documentation MX Merchant MX Connect

Account Error codes

Identify and troubleshoot errors related to account operations and configurations.

This section outlines the error codes and messages specific to Account-related operations. These errors may occur during account creation, updates, retrieval, or validation processes.

Each error includes a standardized error code and a descriptive message to help identify the issue and guide resolution. Use these details to handle failures programmatically and troubleshoot issues effectively during integration.

Error CodesError MessagesConditions
EC-BL-0632Purpose should be one of the following values: SETTLEMENT, FEE.A purpose not configured in the Program Manager setup has been passed in the request.
EC-VA-0005{"errorMessage": "Validation failed.", "errors": [{"field": "sweep.externalAccount", "message": "id or externalId is required."}]}An id or externalId of an external account has not been provided when sweep is enabled.
EC-BL-0020ExternalAccount with id: and externalId: 4313 does not exist.A non-existing id or externalId has been passed in the request.
EC-BL-0403SPAA is supported for the requested action. Please upload the correct document type.A value other than SPAA has been passed for document.type.
EC-BL-0634Please provide external account for sweep to be enabled.External account details are missing while enabling sweep.
EC-BL-4415Cannot perform requested operation on field with operator.An unsupported operator has been passed in the List API.
EC-BL-4201Cannot perform search operation on field.An unsupported field is used in search for the List API.
EC-BL-4337Invalid value entered in the filter.An unsupported field value has been passed in the List API filter.
EC-VA-0005{"errorCode": "EC-VA-0005", "errorMessage": "Validation failed.", "errors": {"field": "configuration.sweep.minBalance", "message": "Must be less than or equal to 1000000.00."}}A minBalance greater than 1,000,000.00 has been passed.
EC-VA-0001{"errorCode": "EC-VA-0001", "errorMessage": "Validation Failed.", "errors": {"field": "configuration.sweep.enable", "message": "Invalid Value for field sweep.enable."}}An unsupported value has been passed for configuration.sweep.enable.
EC-BL-0641{"errorCode": "EC-BL-0641", "errorMessage": "Please provide a method for sweep to be enabled."}The method field is missing under the configuration.sweep node.
EC-BL-0003Account with external reference: already exists.An already existing externalId has been passed in the request.
EC-BL-9815[method] realization interval cannot be less than [x].The provided realization interval is lower than the allowed minimum.