Appendix C

Advanced Configuration Information

This appendix describes advanced configuration capabilities available with the client.

Using Alternate Server Configuration Settings

You use the serverURL and namespaceURI configuration settings if CyberSource changes the convention we use to specify the server URL and namespace URI, but we have not updated the client yet.

For example, these are the server URLs and namespace URI for accessing the ICS services using the Simple Order API version 1.18:

•   Test server URL:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor/

•   Production server URL:

https://ics2ws.ic3.com/commerce/1.x/transactionProcessor/

•   Namespace URI:

urn:schemas-cybersource-com:transaction-data-1.18.

Note When you go to the above URLs using a Web browser, you see a list of the supported versions of the APIs and the associated schema files.

If in the future CyberSource changes these conventions, but we have not yet provided a new version of the client, you will be able to configure your existing client to use the new server and namespace conventions required by the ICS server.

Configuring Your Settings for Multiple Merchant

If you have multiple merchant IDs, or if you are a reseller handling multiple merchants, you can have different configuration settings for different merchant IDs. You set these in the configuration object that you pass to the cybs_run_transaction() function. When using the samples provided in the client package, you set the configuration parameters in cybs.ini file.

All of the properties except merchantID can be prefixed with <merchantID>. to specify the settings for a specific merchant.

Example Merchant-Specific Properties Settings

If you have a merchant with merchant ID of merchant123, and you want enable logging only for that merchant, you can set the enableLog parameter to true for all requests that have merchant123 as the merchant ID:

merchant123.enableLog=true

enableLog=false

The client will disable logging for all other merchants.