Error Definitions

This section describes the Commerce SDK error messages.

ErrorDescription
ECLCommerceError ECLCardReaderCardDataInvalidIncorrect encryption on device.
ECLCommerceError ECLTransactionInvalidCredentialsIncorrect 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 ECLTransactionInvalidTransactionRequestConverge 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 ECLTransactionSignatureCancelledNon-digital signature device (iCMP or iPP320) is used.

Signature is cancelled on the iSC250.

ECLCommerceError ECLTransactionTokenGenerationFailureTokenization is not set up on the Converge account.

There are tokenization issues on Converge.

ECLConvergeError NotPermittedConverge 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.
ECLTransactionFieldTooLongTo 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.

ECLTransactionInvalidTransactionForAccountConverge 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.
ECLTransactionRequestBadUnable to send request to server.

Server is down.

Vendor ID value is greater than 8 digits.

ECLTransportCommunicationFailureCommunication issue on server.
NotPermittedConverge 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.