Error Definitions

Error Description
ECLCommerceError ECLCardReaderCardDataInvalid Incorrect encryption on device.
ECLCommerceError ECLTransactionInvalidCredentials Incorrect Converge credentials passed with the transaction.

To resolve the issues:

  • Pass the correct account ID (AID), user ID (UID), PIN and Vendor ID.
  • Pass the correct paymentGatewayEnviroment parameter value.
  • Use the appropriate CWS version. Check the certificate of the integration.
  • As pre-caution, change the pinpad and cable.
  • Enter the Converge credentials into a personal Postman account and run a Sale transaction (verify the environment to match scenario).
ECLCommerceError ECLTransactionInvalidTransactionRequest Converge is not set up correctly for Commerce SDK processing. The Converge setup must be as follows:
  • Segment: Retail or Service
  • Region: United States or Canada
  • EMV Chip Cards: Enabled
  • Converge Mobile: Enabled
  • HTTPS Transactions: Enabled
  • Dynamic Currency Conversion: Disabled
Customer is attempting to perform a task but Converge is not allowing it.
ECLCommerceError ECLTransactionSignatureCancelled Non-digital signature device (iCMP or iPP320) is used.

Signature is cancelled on the iSC250.

ECLCommerceError ECLTransactionTokenGenerationFailure Tokenization is not set up on the Converge account.

There are tokenization issues on Converge.

ECLConvergeError NotPermitted Converge account or user ID is not configured correctly for the posted transaction.

To resolve the issue:

  • Make sure the account (UID) is set up with proper rights to run Sale transactions.
  • If all shows correct, make sure to install Debug CWS, set Log Level to 9, run a Sale transaction then pull the log.
ECLTransactionFieldTooLong To determine the field that causes the issue:
  1. Install Debug CWS.
  2. Set Log Level to 9.
  3. Run a Sale transaction.
  4. Pull the log.

    A detailed error message displays the field that causes the issue.

ECLTransactionInvalidTransactionForAccount Converge account or user ID is not configured correctly for the posted transaction.

To resolve the issue:

  • Make sure the account (UID) is set up with proper rights to run Sale transactions.
  • If all shows correct, make sure to install Debug CWS, set Log Level to 9, run a Sale transaction then pull the log.
ECLTransactionRequestBad Unable to send request to server.

Server is down.

Vendor ID value is greater than 8 digits.

ECLTransportCommunicationFailure Communication issue on server.
NotPermitted Converge account or user ID is not configured correctly for the posted transaction.

To resolve the issue:

  • Make sure the account (UID) is set up with proper rights to run Sale transactions.
  • If all shows correct, make sure to install Debug CWS, set Log Level to 9, run a Sale transaction then pull the log.