Skip to content

Latest commit

 

History

History
69 lines (44 loc) · 4.42 KB

Configure-cartridge.md

File metadata and controls

69 lines (44 loc) · 4.42 KB

Configure the Cartridge

Prerequisite

If you are new to Cybersource, and would like to start using Cybersource Cartridge quickly, begin by signing up for a Sandbox Account.

You will also need to create an p12 file that you can use to authenticate requests to our sandbox server. Follow same steps to generate Production key and shared secret.

Step 1: Setup Cartridge Path

To set up the cartridge path:

  1. In the Business Manager, go to Administration > Sites > Manage Sites > [yourSite] > Settings

  2. For the Cartridges, enter int_cybersource_sfra:app_storefront_base and select Apply

Step 2: Upload metadata

Cybersource cartridge installed from Market place comes with metadata to import.

  1. Go to Cybersource/metadata/sfra_meta/sites/ folder.
  2. Rename yourSiteID folder name with your site ID in Business Manager (this can be found by looking up Administration->Sites->Manage Sites)
  3. Zip sfra_meta folder.
  4. Go to Administration->Site Development->Site Import & Export and upload sfra_meta.zip file.
  5. Import the uploaded zip file.

On successful import, it creates following metadata.

  • Site Preferences (Cybersource, Cybersource_SecureAcceptance, Cybersource_Paypal, Cybersource_GooglePay, Cybersource_Klarna, Cybersource_VisaCheckout, Cybersource_BankTransfer, Cybersource_PayerAuthentication, Cybersource_WeChat, Cybersource_Tokenization, Cybersource_DecisionManager, Cybersource_TaxConfiguration, Cybersource_DeliveryAddressVerification, Cybersource_DeviceFingerprint, Cybersource_Alipay)
  • Service (cybersource.conversiondetailreport, cybersource.soap.transactionprocessor.generic, cybersource.http.flextoken,cybersource.assymentrickeymanagement)
  • Payment Processor (KLARNA_CREDIT, CYBERSOURCE_ALIPAY, BANK_TRANSFER, CYBERSOURCE_WECHAT)
  • Payment Method
  • Job (CyberSource: Decision Manager Order Update)

Cybersource Core (Required)

Step 1: Upload Cybersource metadata in Business Manager. If not follow "Step 2: Upload metadata" or import "metadata/sfra_meta/meta/Cybersource.xml" in Business Manager (Administration > Site Development > Import & Export)

Step 2: Go to Merchant Tools >Site Preferences Custom Preferences > Cybersource and set values for the following parameters:

Field Description
Enable Cybersource Cartridge Enable or disable Cyberdource Cartridge. If disabled none of the Cybersource services are invoked
Cybersource Merchant ID Cybersource Merchant ID
CyberSource p12 Name Name of the p12 file added in webreferences2 folder.
CyberSource p12 UserName friendly name of first certificate extracted from p12 file.
CyberSource p12 Password password added while creating p12 file.
CyberSource Endpoint Select Test(Test) or Production(Production)
CyberSource Developer ID Unique identifier generated by Cybersource for System Integrator
CyberSource Disable Debug logging Some trace information will be stored in the impex folder on the server with the order ID as the name.
CyberSource Master Card Auth Indicator Preauthorization: 0 passed in request. Final authorization: 1 passed in request. Undefined authorization: omit authIndicator field from the request message
CsTransactionType Select Auth/Sale transaction for Credit card

Services (Required)

Step 1: Upload Cybersource metadata in Business Manager. If not follow "Step 2: Upload metadata" or import "metadata/sfra_meta/services.xml" in Business Manager (Administration > Operations > Import & Export).

Step 2: Go to Administration > Operations > Services

Step 3: Make sure service with name cybersource.soap.transactionprocessor.generic exist.

Payment Processor (Required)

Step 1: Upload Cybersource metadata in Business Manager. If not follow "Step 2: Upload metadata" or import "metadata/sfra_meta/sites/yourSiteID/payment-processors.xml" in Business Manager (Merchant Tools > Ordering > Import & Export).