|
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
- 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.- 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
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....
Copyright © 2002 CyberSource Corporation. |
![]() |
![]() |
![]() |
![]() |