Error Conditions

What to Expect in the Completion Indicator (plResultSuccess) Parameter

As the WwwMrcSubmit/WWWMRCSB API executes, conditions may arise that prohibit it from completing the transaction. These conditions will be monitored and returned in the plResultSuccess parameter. If the results are successful, the value of this parameter will be zero (0). If, for some reason, the transaction could not be completed successfully, a different numeric value will be returned. The table below contains the list of codes that may be returned with the descriptive meaning for each code.

plResultSuccess Values.

ILE Define Code
Description

WWW_MAPIERR_SUCCESS 0
This value indicates a transaction that has resulted in the successful completion of the charge to the customer's credit card. You should record any information returned that is relative to the card processor's return code or host reference and may continue with the completion of the order.

WWW_MAPIERR_LENINV 1
A length parameter or input / output format field was found to have a value that was too small for use when passed for use by the API. This usually is related to the size of the output format structure. The transaction was not submitted. Check the entry to make sure that it contains a value sufficient for the transaction being processed before attempting the request again.

WWW_MAPIERR_NO_RESULTS 2
No results, or invalid results, were returned from the processing host for the transaction that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.

WWW_MAPIERR_INPUT_FORMAT 4
The Input Data Format parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of input formats and attempt the request again.

WWW_MAPIERR_OUTPUT_FORMAT 5
The Output Data Format parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of output formats and attempt the request again.

WWW_MAPIERR_TRANSMIT_METHOD 6
The Transmission Method parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of transmission methods and attempt the request again.

WWW_MAPIERR_HOST_NAME 31
The host name or IP address specified in the pachRemoteHost parameter could not be found. The transaction was not submitted. It is possible that you are attempting to connect to a host that does not exist. Network or domain name activity may also be a factor in this error. Check the value of the pachRemoteHost parameter before submitting the request again. You may also wish to check your TCP/IP configuration and domain name server configuration (if one exists) to make sure that the host desired has been set up properly.

WWW_MAPIERR_CONNECT_FAILED 32
A connection between Merchant/400 and the remote host system could not be established. The transaction was not submitted. It is possible that you are attempting to connect to a server that does not exist or that is not currently active. Network activity may also be a factor in this error. Check the value of the pachRemoteHost and lRemotePort parameters before submitting the request again. You may also wish to utilize other TCP/IP utilities (ping, etc.) to check your connection capabilities to the host desired.

WWW_MAPIERR_HANDSHAKE_FAILED 33
The handshake between Merchant/400 and the remote host system has failed. The transaction was not submitted to avoid the possibility of sending information in an unprotected manner. It is possible that you are attempting to connect to a server or port that does not support SSL. Check the value of the pachRemoteHost and lRemotePort parameters before submitting the request again.

WWW_MAPIERR_TRANS_REJECTED 51
The transaction has been rejected by the credit card processor or the partner processing agency. You may wish to look at other results found in the output format structure to determine the source of the error before submitting the request again.

WWW_MAPIERR_TRANS_TEMPREJECT 52
The transaction has been temporarily rejected by the credit card processor. You may wish to look at other results found in the output format structure to determine the source of the error before submitting the request again.

WWW_MAPIERR_ACTIVATION 95
The activation code for the product has either not been set, or has been set incorrectly. The transaction was not submitted. Set the activation key for the API and attempt the request again.

WWW_MAPIERR_INTERNAL 96
An internal error has occurred that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.

WWW_MAPIERR_PARM_INV 97
One of the parameters or input / output format fields was invalid when passed for use by the API. The transaction was not submitted. Check the entries to make sure that they match the list of required information and attempt the request again.

WWW_MAPIERR_PARM_NULL 98
One of the parameters or input / output format fields were not passed or defined for use by the API. The transaction was not submitted. Check the entries to make sure that they match the list of required information and attempt the request again.

WWW_MAPIERR_MALLOC 99
A memory error has occurred that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.

ILE Define	Code	Description
WWW_MAPIERR_SUCCESS	0	This value indicates a transaction that has resulted in the successful completion of the charge to the customer's credit card. You should record any information returned that is relative to the card processor's return code or host reference and may continue with the completion of the order.
WWW_MAPIERR_LENINV	1	A length parameter or input / output format field was found to have a value that was too small for use when passed for use by the API. This usually is related to the size of the output format structure. The transaction was not submitted. Check the entry to make sure that it contains a value sufficient for the transaction being processed before attempting the request again.
WWW_MAPIERR_NO_RESULTS	2	No results, or invalid results, were returned from the processing host for the transaction that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.
WWW_MAPIERR_INPUT_FORMAT	4	The Input Data Format parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of input formats and attempt the request again.
WWW_MAPIERR_OUTPUT_FORMAT	5	The Output Data Format parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of output formats and attempt the request again.
WWW_MAPIERR_TRANSMIT_METHOD	6	The Transmission Method parameter was invalid when passed for use by the API. The transaction was not submitted. Check the entry to make sure that it matches the list of transmission methods and attempt the request again.
WWW_MAPIERR_HOST_NAME	31	The host name or IP address specified in the pachRemoteHost parameter could not be found. The transaction was not submitted. It is possible that you are attempting to connect to a host that does not exist. Network or domain name activity may also be a factor in this error. Check the value of the pachRemoteHost parameter before submitting the request again. You may also wish to check your TCP/IP configuration and domain name server configuration (if one exists) to make sure that the host desired has been set up properly.
WWW_MAPIERR_CONNECT_FAILED	32	A connection between Merchant/400 and the remote host system could not be established. The transaction was not submitted. It is possible that you are attempting to connect to a server that does not exist or that is not currently active. Network activity may also be a factor in this error. Check the value of the pachRemoteHost and lRemotePort parameters before submitting the request again. You may also wish to utilize other TCP/IP utilities (ping, etc.) to check your connection capabilities to the host desired.
WWW_MAPIERR_HANDSHAKE_FAILED	33	The handshake between Merchant/400 and the remote host system has failed. The transaction was not submitted to avoid the possibility of sending information in an unprotected manner. It is possible that you are attempting to connect to a server or port that does not support SSL. Check the value of the pachRemoteHost and lRemotePort parameters before submitting the request again.
WWW_MAPIERR_TRANS_REJECTED	51	The transaction has been rejected by the credit card processor or the partner processing agency. You may wish to look at other results found in the output format structure to determine the source of the error before submitting the request again.
WWW_MAPIERR_TRANS_TEMPREJECT	52	The transaction has been temporarily rejected by the credit card processor. You may wish to look at other results found in the output format structure to determine the source of the error before submitting the request again.
WWW_MAPIERR_ACTIVATION	95	The activation code for the product has either not been set, or has been set incorrectly. The transaction was not submitted. Set the activation key for the API and attempt the request again.
WWW_MAPIERR_INTERNAL	96	An internal error has occurred that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.
WWW_MAPIERR_PARM_INV	97	One of the parameters or input / output format fields was invalid when passed for use by the API. The transaction was not submitted. Check the entries to make sure that they match the list of required information and attempt the request again.
WWW_MAPIERR_PARM_NULL	98	One of the parameters or input / output format fields were not passed or defined for use by the API. The transaction was not submitted. Check the entries to make sure that they match the list of required information and attempt the request again.
WWW_MAPIERR_MALLOC	99	A memory error has occurred that prevents the continuing execution of the API. The results of the transaction are unknown. Manual transaction checking should be performed to insure that the charge has been approved before the order is completed.