Search documentation:
	Help  Advanced
Published 05/15/2002

Appendix A

CyberSource Message Manager

This appendix describes the Message Manager, which allows customization of reply flags and error messages.

Using Message Manager

You can do the following using The Message Manager:

• Customize CyberSource error messages
• Provide internationalization/localization support for error messages

CyberSource errors populate the MSCS 2000 purchase errors dictionary on every failed transaction. These raw error messages can help you for debugging purposes, but should never be displayed to your customer.

The Message Manager translates raw CyberSource error messages in the purchase errors dictionary into your own customer-friendly messages.

Using Message Manager

1. Using a text editor, open the rc.xml file, located in the root directory of your Web site. The file is available in the c:\inetput\wwwroot\<mystore>\rc.xml directory.
2. If you want to add a customized message, add a line in the following format:

<Entry Name="CyberSourceErrorMessage" Type="_Purchase_Errors">

<ValueLanguage="English">YourMessageForCustomer</Value></Entry>

Example  Customizing a DCARDREFUSED Error Message

<Entry Name="DCARDREFUSED" Type="_Purchase_Errors">

<ValueLanguage="English">We were unable to validate your credit card. Please call our customer service department at 800 555-1234.

</Value></Entry>

Note  The DCOMPONENT error flag can be translated to show hard-coded error messages for component failures to display a customized error string.

How Message Manager Works

For every transaction sent to the CyberSource, a reply flag is returned and checked against the Message Manager. The following outcomes are possible:

• If the Message Manager has a customized message defined for the reply flag, then the customized message is logged to the purchase errors dictionary.
• If there is not a customized message defined, then the default reply flag is logged.

With Message Manager mapping, you can send your customer a customized message instead of the default reply flag.

Example  CyberSource Reply Flag You Receive For An Invalid Credit Card Number

ics_rmsg = The following request field(s) is either invalid or missing: customer_cc_number

ics_rflag = DINVALIDCARD

Reply Your Customer Receives For An Invalid Credit Card Number Without Message Manager

The following request field(s) is either invalid or missing: customer_cc_number.

Reply Your Customer Receives For An Invalid Credit Card Number With Message Manager

We are having trouble verifying your contact information, please call....