Cybersource is a leading provider of Credit Card Processing for Business. We have to use this for the credit card processing. Hybris provides this OOB itself. This document explains the steps to integrate with Cybersource using the API provided by Hybris.
Steps to integrate with Cybersource using Hybris API
1 Sign up for a test business login with Cybersource
Sign up for the test account with cybersource by going to Sign-up for a test account today
2 Preparing the cybersource extension
• Credentials Username: kmteststore and Password: test@123
• Generate the security key by logging into the test account. There will be two options while selecting the security key. One is for SOAP Order API and the other for Simple Order API, Select Simple Order API to generate the key, because, hybris uses Simple Order API to interact with Cybersource.
• Activate Hosted order page and Recurring Billing (by ticket in test merchant account)
• While Creating the test account you will give the merchant ID. Now, name the generated security key as <merchantID>.p12
• For sample of security key of merchantID KMteststore attached below
• Rename the file /resources/cybs.properties.template to /resources/cybs.properties. Edit the file providing at least the value for "merchantID" property.
• Copy this security file to the /config/security folder of Hybris server.
Dowload HOP.jsp page from Hosted Order page of cybersource site. Sample file attached below(Note this file is merchant dependent)
Enter new properties in config/local.properties. ############# Hosted Order Page settings #######################################################################
hop.post.url=https://orderpagetest.ic3.com/hop/orderform.jsp
# cybersource connectivity values
hop.cybersource.testCurrency=EUR
hop.cybersource.merchantID=KMteststore
##Below hop.cybersource.sharedSecret and hop.cybersource.serialNumber value should copy from HOP.jsp (Note -below value is for KMteststore merchantID)
hop.cybersource.sharedSecret=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDL+8vfGDuJCFCaXTmxXKNizMAiHW90WK2XIwZOlURJoD4yCPzBjDbuD3CYdNz5l9iGnpPvm3Ad3jzTPKNC9s/C/yFP7cmrqNhOv3lnRvTTDIZtCJIBRvABlS4lXHR6In7dhnNSCaQmDbeRFk5P39dvAOncjIir8CBfDqKJPc0KNwIDAQAB
hop.cybersource.serialNumber=3431909238000176056165
hop.cybersource.testCurrency.KMStore=USD
######## CyberSource Hosted Order Page Properties
##### Appearance Configuration
### URL for an image to display in the background of the order page,
## such as https://www.example.com/images/background.gif.
## Note: Make sure to use a secure (HTTPS) URL so that your customers'
## web browser does not display a security warning.
#hop.cybersource.appearance.backgroundImageURL.apparel-uk=
## Use one of these values:
## - blue, standard (Gray), gray, green, orange, red, custom
## If you choose custom, the following four fields become required.
hop.cybersource.appearance.colorScheme=blue
hop.cybersource.appearance.colorScheme.KMStore=orange
## Enable these properties if you choose "custom" for [hop.cybersource.appearance.colorScheme].
hop.cybersource.appearance.barColor.KMStore=#37B837
hop.cybersource.appearance.barTextColor.KMStore=#FFFFFF
hop.cybersource.appearance.messageBoxBackgroundColor.KMStore=#BBF1BB
hop.cybersource.appearance.requiredFieldColor.KMStore=#000000
# PaymentInfo validates that the card number is plausible.
# Setting paymentinfo.creditcard.checknumber=false will prevent PaymentInfo.createItem()
# from throwing an exception if the card number is invalid.
paymentinfo.creditcard.checknumber=false
# Payment Service provider. "Cybersource" or "Mockup"
payment.service-provider.name=Cybersource
• Now build the platform.
4. Cybersource Reason code and Reason text
Below Decision, reason code and text send in response of cybersource
Decision Reason Code Reason Text
ACCEPT 100, 110 Success
REVIEW 200, 201, 230, 520 Success
REJECT 102, 200, 202, 203, 204, 205,
207, 208, 210, 211, 221, 222, 230,
231, 232, 233, 234, 236, 240, 476 Failure
REJECT 475 Payer Authentication
ERROR 150, 151, 152, 250 System error
5.Configuring the Hosted Order Page(Cybersource)
This section provides configure the default settings for the Hosted Order Page and downloading the security script.
Choosing Your Default Settings for the Hosted Order Page
This section is required for all users because the Hosted Order Page does not work unless you have chosen and saved your default settings once. Afterward, you can return to the settings page at any time to make changes if you wish.
(Note-To choose or modify the default settings, you must be an administrator user.)
• In this section, you choose the colors and background image for the page, the fields to display to customers, and you add text to include on the order and receipt pages. Later, if you choose to do so, you can customize each section of the Hosted Order Page by adding to and modifying the HTML content of the page.
• Log into the Business Center with your merchant user name and password.
• Browse to Settings > HOP Settings.
• Configure your default settings as needed. The settings page is divided into separate sections, which are detailed below:
i. Data Entry Fields
ii. Reply Management Fileds
iii. Appearance Fields
iv. Notification Fields
• If you plan to use CyberSource’s hosted form, click View to preview the form and make changes to your settings if necessary.
• When done, click Update. The Business Center saves your changes.
Steps to integrate with Cybersource using Hybris API
1 Sign up for a test business login with Cybersource
Sign up for the test account with cybersource by going to Sign-up for a test account today
2 Preparing the cybersource extension
• Credentials Username: kmteststore and Password: test@123
• Generate the security key by logging into the test account. There will be two options while selecting the security key. One is for SOAP Order API and the other for Simple Order API, Select Simple Order API to generate the key, because, hybris uses Simple Order API to interact with Cybersource.
• Activate Hosted order page and Recurring Billing (by ticket in test merchant account)
• While Creating the test account you will give the merchant ID. Now, name the generated security key as <merchantID>.p12
• For sample of security key of merchantID KMteststore attached below
• Rename the file /resources/cybs.properties.template to /resources/cybs.properties. Edit the file providing at least the value for "merchantID" property.
• Copy this security file to the /config/security folder of Hybris server.
Dowload HOP.jsp page from Hosted Order page of cybersource site. Sample file attached below(Note this file is merchant dependent)
Enter new properties in config/local.properties. ############# Hosted Order Page settings #######################################################################
hop.post.url=https://orderpagetest.ic3.com/hop/orderform.jsp
# cybersource connectivity values
hop.cybersource.testCurrency=EUR
hop.cybersource.merchantID=KMteststore
##Below hop.cybersource.sharedSecret and hop.cybersource.serialNumber value should copy from HOP.jsp (Note -below value is for KMteststore merchantID)
hop.cybersource.sharedSecret=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDL+8vfGDuJCFCaXTmxXKNizMAiHW90WK2XIwZOlURJoD4yCPzBjDbuD3CYdNz5l9iGnpPvm3Ad3jzTPKNC9s/C/yFP7cmrqNhOv3lnRvTTDIZtCJIBRvABlS4lXHR6In7dhnNSCaQmDbeRFk5P39dvAOncjIir8CBfDqKJPc0KNwIDAQAB
hop.cybersource.serialNumber=3431909238000176056165
hop.cybersource.testCurrency.KMStore=USD
######## CyberSource Hosted Order Page Properties
##### Appearance Configuration
### URL for an image to display in the background of the order page,
## such as https://www.example.com/images/background.gif.
## Note: Make sure to use a secure (HTTPS) URL so that your customers'
## web browser does not display a security warning.
#hop.cybersource.appearance.backgroundImageURL.apparel-uk=
## Use one of these values:
## - blue, standard (Gray), gray, green, orange, red, custom
## If you choose custom, the following four fields become required.
hop.cybersource.appearance.colorScheme=blue
hop.cybersource.appearance.colorScheme.KMStore=orange
## Enable these properties if you choose "custom" for [hop.cybersource.appearance.colorScheme].
hop.cybersource.appearance.barColor.KMStore=#37B837
hop.cybersource.appearance.barTextColor.KMStore=#FFFFFF
hop.cybersource.appearance.messageBoxBackgroundColor.KMStore=#BBF1BB
hop.cybersource.appearance.requiredFieldColor.KMStore=#000000
# PaymentInfo validates that the card number is plausible.
# Setting paymentinfo.creditcard.checknumber=false will prevent PaymentInfo.createItem()
# from throwing an exception if the card number is invalid.
paymentinfo.creditcard.checknumber=false
# Payment Service provider. "Cybersource" or "Mockup"
payment.service-provider.name=Cybersource
• Now build the platform.
4. Cybersource Reason code and Reason text
Below Decision, reason code and text send in response of cybersource
Decision Reason Code Reason Text
ACCEPT 100, 110 Success
REVIEW 200, 201, 230, 520 Success
REJECT 102, 200, 202, 203, 204, 205,
207, 208, 210, 211, 221, 222, 230,
231, 232, 233, 234, 236, 240, 476 Failure
REJECT 475 Payer Authentication
ERROR 150, 151, 152, 250 System error
5.Configuring the Hosted Order Page(Cybersource)
This section provides configure the default settings for the Hosted Order Page and downloading the security script.
Choosing Your Default Settings for the Hosted Order Page
This section is required for all users because the Hosted Order Page does not work unless you have chosen and saved your default settings once. Afterward, you can return to the settings page at any time to make changes if you wish.
(Note-To choose or modify the default settings, you must be an administrator user.)
• In this section, you choose the colors and background image for the page, the fields to display to customers, and you add text to include on the order and receipt pages. Later, if you choose to do so, you can customize each section of the Hosted Order Page by adding to and modifying the HTML content of the page.
• Log into the Business Center with your merchant user name and password.
• Browse to Settings > HOP Settings.
• Configure your default settings as needed. The settings page is divided into separate sections, which are detailed below:
i. Data Entry Fields
ii. Reply Management Fileds
iii. Appearance Fields
iv. Notification Fields
• If you plan to use CyberSource’s hosted form, click View to preview the form and make changes to your settings if necessary.
• When done, click Update. The Business Center saves your changes.
