To install the Smartpay cartridge for SFCC server, you first need to add the cartridge in SFCC UX Studio. Please follow the instrunctions below to install Smartpay.

  1. In UX Studio, select File > Import menu item.
  2. In the import dialog, select General > Existing Projects in the workspace and click on Next.
  3. Ensure Select archive file is selected and select the compressed cartridge file by clicking on the Browse button.
  4. Click on the Finish button to import the cartridge.
  5. Studio will now ask you if you want to link the cartridge to your active DigitalServer connection. Click on yes.
    You can also link the cartridge manually to your server by checking the project under project references in the server connection properties.

Business Manager Configurations

For the Smartpay integration to work, the following needs to be configured in the Business manager.

Activating the cartridge in Business Manager

Before Smartpay becomes available for your shoppers, the cartridges have to be added to the cartridge path of the Site. In order to do this, follow the following instructions:

  1. Log into Business Manager.
  2. Navigate to Administration > Sites > Manage Sites.
  3. Click on the site name and on the next page go to the Settings tab.
  4. In the Cartridges input field add int_smartpay_sfra: int_smartpay_core in front of the base cartridge path.
  5. Click on the Apply button.
  6. To activate the cartridge for the Sandbox/Development/Production instances repeat steps 4 and 5 after selecting the appropriate instance from the Instance Type dropdown menu.
  7. Repeat steps 3 to 6 for each site that is to use Smartpay.
  8. Go to Manage the Business Manager site.
  9. In the Cartridges input field add bm_smartpay:bc_smartpay:int_smartpay_core .
  10. Click on the Apply button.

Enable Cartridge Module

To enable the Cartridge module

  1. Go to Administration > Organization > Roles & Permissions.
  2. Click on Administrator and click on the Business Manager Modules tab.
  3. In the Select Context dialog, check your site ID checkbox and click the Apply button.
  4. Find Smartpay and check the checkbox to enable it.
  5. Click on the Update button.

Importing Metadata

For the Smartpay integration to work, the following object structures (metadata) needs to be imported and configured in the Business manager.

  1. In the cartridge bundle find metadata/ smartpay-meta-import/sites/RefArchJP folder.
  1. Rename this RefArchJP folder to the ID of your site. If you have multiple sites to which these meta has to be imported, then copy and paste this RefArchJP folder to replicate for other sites. Renames those folders with ID of corresponding sites.
  2. In the cartridge bundle, inside metadata folder, compress smartpay-meta-import folder to generate file.
  3. Go to Business Manager Menu > Administration > Site Development > Site Import & Export
  4. Under Import > Upload Archive ensure that the Local radio button is enabled.
  5. Click on the Choose File input field, select the file you just created and click on the upload button.
  6. After finishing the upload, from the Archives list click the radio button corresponding to and click on the Import button.
  7. Click on the OK button of the confirmation box asking, Are you sure that you want to import the selected archive?

After the successful metadata import, the following attributes should have been created:

Custom Site Preferences

In Business Manager, navigate to the Merchant Tools > Site Preferences > Custom Preferences. Custom site preference groups with the ID ‘Smartpay Settings’ will be available.

Please select it and edit the attributes according to your Smartpay account data.

For each site, set the values for your site preferences.

  1. Is Smartpay Enabled (ID: isSmartpayEnabled, Type: Boolean) – Enable and disable Smartpay and its functionality in a single point.
  2. Api Secret (ID: smartpayApiSecret, Type: String) – Api secret of Smartpay.
  3. Payment Mode (ID: smartpayCaptureMethod, Type: Enum of Strings) – Select transaction type.
  4. Minimum Checkout Value (ID: smartpayMinPrice, Type: String) – Set minimum amount of order in order to select Smartpay.
  5. Maximum Checkout Value (ID: smartpayMaxPrice, Type: String) – Set maximum amount of order in order to select Smartpay.
  6. Orders Created Time(ID: smartpayOrdersCreatedTime, Type: String) – Find the orders behind this given time. Set time in minutes.

Payment Methods

Under Merchant Tools > Ordering > Payment Methods, check that payment method with ID ‘SMARTPAY’ is created.

Payment Processor

Under Merchant Tools > Ordering > Payment Processors, check that payment processors with ID ‘SMARTPAY’ is created.

HTTP Services

Under Administration > Operations > Services, check that service with ID ‘smartpay.http.generic is created.


Under Administration > Operations > Jobs, check that job with ID ‘SmartpayPlaceOrder’ is created.