Salesforce Commerce Cloud (SOAP) | Smartpay Fuse Developer Portal

Product Overview

With your Smartpay Fuse account, the Cybersource plugin for Salesforce Commerce Cloud makes the technical side of things far less complicated. This means you can help keep deployment time and disruption to a minimum and you can get up and running quickly.

Card Payments
3D Secure (SCA Compliant)
Flex MIcroform (our solution for Hosted Fields)
Tokenisation
Google Pay
Apple Pay
Fraud Prevention Tools

Integration Features:
- REST API
- SOAP API
- Microform (our solution for hosted fields)
- 3DSecure
Channels:
- eComm (CNP)
- inApp
Payment Methods:
- Visa
- MasterCard
- Maestro
- American Express
- Discover
- Diners
- Apple Pay
- Google Pay
- Click to Pay
- Alternative Payment Methods:
  - Alipay
  - iDEAL
  - Sofort
  - PayPal (Express Checkout, Credit, Billing Agreement)
  - Klarna (v2)
  - Bancontact
  - WeChat
Payment Functions:
- Authorisation
- Sale
- Token Management Services (CIT only)
- Network Tokens
- Webhooks (Token Lifecycle Update)
Fraud Management:
- Decision Manager
- Device ID

Integrating Salesforce B2C Commerce with Smartpay Fuse

Smartpay Fuse has been created in partnership with VISA Cybersource.. When you click through to enable the integration you may notice reference to the Cybersource brand and see some features that are not part of the Smartpay Fuse gateway. If you have any questions about this plugin or its feature set then please don’t hesitate to Get in Contact.

The following features are supported by this integration, but cannot be enabled for your Smartpay Fuse account.

eCheck
Delivery Address Verification
Tax Calculation
J.Crew
ELO
Carte Bancaires

You will be able to configure this integration to either Test or Production. If you do not yet have a live Smartpay Fuse account, or you wish to first test the integration, then creating a sandbox account will not only allow you to start programmatic integration but also provides access to the Enterprise Business Centre servicing portal.

Visit our sandbox creation page here.
Complete the registration form.
Click submit to create your sandbox account.

Note: on submitting your application, you will receive an automated email from our partner, Cybersource, with first time login and password reset instructions. Be sure to check your junk mailbox if this doesn’t arrive within 2 minutes of clicking Submit.

Getting Started

Prerequisite - Salesforce – In order to use the Cybersource Storefront Reference Architecture cartridge please make sure you have an active instance of Salesforce and you have install and configure the SFRA app_storefront_base cartridge. This integration supports Storefront Reference Architecture (SFRA) v7.0.

For general information about Commerce Cloud and SFRA, see the Salesforce B2C Commerce Infocentre (salesforce.com).

Prerequisite - Smartpay Fuse

You will be able to configure this integration to either Test or Live.

Create REST Keys (required - will need in addtion to the SOAP key)

a. Sign into your account (Live or Test respectively)

b. Access Payment Configuration -> Key Management

c. Select the 'Generate Key' button in the top right hand corner

d. Select your key type as 'REST - Shared Secret Key' and Generate Key

e. Copy your KeyID and Shared Secret Key values and save them securely

Create SOAP Keys (required - will need in addtion to the REST key)

a. Sign into your account (Live or Test respectively)

b. Access Payment Configuration -> Key Management

c. Select the 'Generate Key' button in the top right hand corner

d. Select your key type as 'SOAP Toolkit' and Generate Key

e. Copy the Secret Key value and save them securely

Setup Workspace

Create a 'Cybersource' folder in your workspace and place the cartridge int_Cybersource_sfra (int_Cybersource for controller version) that was downloaded from the marketplace in Step 2

Note if you have a different project setup you will need to open the file /package.json and modify the paths.base value to point to your app_storefront_base cartridge. This path is used by the JS and SCSS build scripts.

If using VSCode, install the extension Phrophet Debugger link or any other SFCC extension and include the following in dw.json().

                {
  "hostname": "your-sandbox-hostname.demandware.net",
  "username": "yourlogin",
  "password": "yourpwd",
  "version": "version_to_upload_to",
  "cartridge": [
              "int_cybersource_sfra",
              "app_storefront_base",
              "modules"
  ]
}

Note if you are using a different IDE please refer to the respective developer guide to setup the workspace.

Build and Upload Code

Prerequisite: Install node under the Cybersource folder

Install sgmf-scripts and copy-webpack-plugin with the following command

                npm install sgmf-scripts && npm install copy-webpack-plugin

Compile the JS and SCSS code with the following command

                npm run compile:js && npm run compile:scss

Upload the code to your Salesforce Commerce Cloud instance

                
npm run uploadCartridge

Configure the Cartridge

Setup the Cartridge path

Go to settings within Business Manager (Administration > Sites > Manage Sites > [your site] > Settings
For Cartridges enter int_Cybersource_sfra:app_storefront_base then select apply

Upload metadata

Go to folder Cybersource/metadata/sfra_meta/sites/
Rename yourSiteID folder name to your site ID - this can be looked up in Administration > Sites > Manage Sites
Zip the sfra_metadata folder
Upload sfra_meta.zip using Site Import & Export - Administration > Site Development > Site Import & Export
Import the uploaded zip file

Upon successful import the following metadata is created:

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

Add Keys and Enable Cartridge

Navigate to Merchant Tools > Custom Preferences > Cybersource Core to add your Smartpay Fuse Merchant ID and keys, set the desired endpoint (test/production), and to enable the cartridge.

Additional custom preferences can be configured in Merchant Tools > Custom Preferences

Configure Payment Methods

Navigate to Merchant Tools > Ordering > Payment Methods and select CREDIT_CARD to select the card capture method. Confirm that Payment Processor = Cybersource_CREDIT before proceeding.

To set Microform as thecard capture mechanism, navigate to Merchant Tools > Site Preferences > Custom Preferences > Cybersource_SecureAcceptance, and set Secure Acceptance Type as SA_FLEX. Add your REST keys to Secure Acceptance Flex Shared Secret and Secure Acceptance Flex KeyId, then select the CS Transaction Type according to your preference.

Although we have added flexible integration options, we recommend utilising our Microform solution for capturing card details, this provides a full PCI-A Solution whilst offering flexibility around your chosen UI.

Please refer to the user guide available with the downloaded cartridge for full guidance on configuring all payment methods and additional features.

Ready to Go Live

When you are ready to go live configure the cartridge using your production Smartpay Fuse account details.

Further Information

Testing Guide landing page can be found here

Generic test card numbers (no 3DS) can be found here

3DS testing use cases can be found here

Information on PCI-DSS for each of the integration options can be found here