Configuring General Settings

The settings under the General section apply to all payment methods. Follow these steps to complete this section:
  1. From the Cybersource setting, click the arrow to expand the General section.
  2. From the
    Debug Mode
    drop-down list, choose
    Yes
    to troubleshoot using the
    Adobe Commerce Cloud
    Cybersource logs (
    cybs.log
    ). Diagnostic information is stored in log files on the
    Adobe Commerce Cloud
    web server.
  3. From the
    Sort Order
    drop-down list, change the default module sort order.
  4. In the
    Show Exact Rejection or Error Message to Users
    option, set to
    No
    when you want the general error message displays according to
    Adobe Commerce Cloud
    in all rejection and error cases. Set to
    Yes
    when you want the general error message displays according to the responses from Cybersource in all rejection and error cases.
  5. In the
    Override Payment Error Route Path
    field, enter the error page route path. When no path is entered, the checkout/cart route is used when you leave the default
    Use system value
    box checked.

Configuring WebService

The WebService configuration includes the default
Adobe Commerce Cloud
merchant ID (applies to all the payment methods), the REST shared key, and the SOAP key detail. Follow these steps to complete the configuration:
  1. Click
    WebService Configuration
    to expand the section.
  2. In the
    Merchant ID
    field, enter your Cybersource merchant ID.
  3. From the
    Test Mode
    drop-down list, choose
    Yes
    when you are using the
    Business Center
    testing environment, or
    No
    when you are using the production
    Business Center
    .
  4. This field is optional. In the
    Developer ID
    field, enter the developer ID. It must not be longer than eight characters. You can request Cybersource to assign you a developer ID.
  5. In the
    SOAP Key Detail
    field, enter the key you generated from the SOAP toolkit API. If you have not generated a key, see Creating a SOAP Toolkit Key for instructions.
  6. In the
    REST API Key Detail
    field, enter the REST key you generated from the
    Business Center
    . If you have not generated a REST Shared Secret Key Pair, see Creating a Shared Secret Key Pair for instructions.

    ADDITIONAL INFORMATION

    Proper configuration of the SOAP WebService is required for the functioning of other services including Tax Calculation, Secure Acceptance, PayPal, Account Takeover Protection, and Apple Pay. If you experience issues with these modules, ensure that the SOAP WebService options are configured correctly. The SOAP API Key Detail should have the correct value and the Test Mode option should match the correct environment for the Cybersource
    Business Center
    is set to the testing environment.
  7. In the
    REST API Shared Secret Key
    field, enter the Shared Secret key you generated from the
    Business Center
    . If you have not generated a REST Shared Secret Key Pair, see Creating a Shared Secret Key Pair for instructions.

    ADDITIONAL INFORMATION

    Proper configuration of the REST Web Service is required for other services including Flex Microform,
    Decision Manager
    , and the Account Updater. If you experience issues with these modules, ensure that the REST Web Service options are configured properly. The API Key Detail and API Shared Secret Key should have the correct value, and the Test Mode option should match the correct environment for the Cybersource
    Business Center
    .

Configuring Device Fingerprinting

Device Fingerprinting is used with
Decision Manager
for all relevant payment methods. If you are not using
Decision Manager
, you must disable this module. Follow these steps to configure device fingerprinting:
  1. Click
    Device Fingerprint
    to expand the section.
  2. In the
    Active
    field, choose
    Yes
    to activate it or
    No
    to deactivate it if you are not using
    Decision Manager
    .
  3. In the
    Org ID
    field, enter the value provided to you by Cybersource. To obtain this value either for test or production, contact your Cybersource representative.

Configuring the Delivery Address Verification Service

The Delivery Address Verification Service acts as an additional layer of address verification and normalization on the shipping page. Follow these steps to configure this section:
  1. Click
    Delivery Address Verification Service
    to expand the section.
  2. From the
    Address verification
    drop-down list, choose
    Yes
    to enable this service or
    No
    to disable this service.
  3. From the
    Address Force Normalization
    drop-down list, choose
    Yes
    to require the use of suggested address alternatives or
    No
    to make the suggested address alternatives optional.