Configuring the Plugin
note
If migrating from CyberSource plugin 1.x to 2.x, do the following:
- Connect to your database and update all CyberSource configurations to draft state by running
UPDATE TPAYMENTPROVIDERCONFIG SET STATUS = 'DRAFT' WHERE PAYMENT_PROVIDER_PLUGIN_ID IN ('directPostCybersourcePaymentProviderPlugin', 'hostedPageCreditCardCybersourceProviderPlugin') AND STATUS = 'ACTIVE';. - In Commerce Manager, update the
REST_API_KEYandREST_API_SECRETvalues in the provider's Configuration data settings, and re-activate the configuration.
After the CyberSource plugin is added to the ep-commerce directory, configure the plugin. In Commerce Manager, you can associate it to one or more stores and activate it.
Open Commerce Manager.
On the toolbar, click Configuration.
Go to Payment Methods > Payment Configurations.
Click Create.
In the New Payment Configuration wizard, enter the following details:
In the Provider field, select
CYBERSOURCE.In the Method field, select one of the following:
MICROFORM_CREDIT_CARDUNIFIED_CHECKOUT_CREDIT_CARDDIRECT_POST_CREDIT_CARD(deprecated)HOSTED_PAGE_CREDIT_CARD(deprecated)
In the Configuration field, enter a name for the payment provider.
This name is unique to the system and is shown in the Payments tab in store configuration.
In the Display name field, enter the name to display in the user interface.
In the Localized display name field, specify the localized value of the payment configuration.
In the Configuration data settings section, click the pencil icon to edit the values. Each method shows only the keys it uses. See Configuration keys.
Click Save.
Activate the plugin within Commerce Manager. For more information about activating a plugin, see Configuring a payment provider.
Associate the plugin with a store. For more information, see Associating a payment plugin to a store.
Configuration keys
| Key | Description | Microform | Unified Checkout | Direct Post and Hosted Page |
|---|---|---|---|---|
MERCHANT_ID | Your CyberSource merchant identifier. | ✅ | ✅ | ✅ |
REST_API_KEY | Your CyberSource REST API key. | ✅ | ✅ | ✅ |
REST_API_SECRET | Your CyberSource REST API secret. | ✅ | ✅ | ✅ |
PRODUCTION_MODE | A boolean value indicating whether the CyberSource requests should be made in production. Set either True or False. | ✅ | ✅ | ✅ |
DEVELOPER_ID | An optional field specifying your CyberSource developer identifier. | ✅ | ✅ | ✅ |
STOREFRONT_BASE_URLS | Required. A comma-separated list of the storefront base URLs that show the card fields, such as https://www.example.com. Use https, the host name and the port if it is not the default, without a path. If the storefront URL is not on the list, the card fields do not load. | ✅ | ✅ | ❌ |
CARD_BRANDS | A comma-separated list of the card brands to accept, such as VISA,MASTERCARD. If blank, the plugin accepts VISA,MASTERCARD,AMEX,DISCOVER. Microform has no card brand setting in the Business Center, so set the card brands here. Unified Checkout uses the card brands that are set in the Business Center. For more information, see Setting up Unified Checkout. | ✅ | ❌ | ❌ |
SA_PROFILE_ID | Your CyberSource Secure Acceptance profile ID. | ❌ | ❌ | ✅ |
SA_ACCESS_KEY | Your CyberSource Secure Acceptance access key. | ❌ | ❌ | ✅ |
SA_SECRET_KEY | Your CyberSource Secure Acceptance secret key. | ❌ | ❌ | ✅ |