SFCC Implementation Guide

Set Up Business Manager

The Radial SFCC connector comprises three cartridges that support the integration:

int_radial_SFRA: This cartridge contains code related to Radial Payment Solutions modules.
int_radial_oms: This cartridge contains code related to Radial Order Management (ROM).
int_non_radial_oms: This cartridge is for Radial clients who use a third-party OMS and integrate with Radial Payment Solutions. In this case, the client can integrate the third-party OMS directly with Radial for payment settlement or they can use this cartridge to call the Radial APIs. This cartridge contains public URLs exposed with basic authentication to call the Radial APIs through SFCC.

Note: If clients want to integrate with both Radial Payment Solutions and Radial Order Management, they do not need to add the int_non_radial_oms cartridge into the cartridge path.

Install the Cartridge

To install a cartridge:

Upload the cartridges to your environment/sandbox using the standard flow.
Upload and Import metadata from the metadata folder. To do so, select:

Business Manager > Administration > Site Development > Site Import & Export

Either import the complete zip folder as shown above or import the individual XML files.
Insert the cartridge into the site cartridge path. Select:

Business Manager > Administration > Sites > Manage Sites > [Your Site] > Settings

The updated path is now:

int_radial_oms:int_radial_SFRA:int_non_radial_oms:plugin_instorepickup:app_storefront_base

Note: The cartridge path has to be updated as per the integration with Radial.
Insert the cartridge into the Business Manager cartridge path. Select:

Business Manager > Administration > Sites > Manage Sites > Manage the Business Manager Site > Settings

Configuration

Configure Services and Service Credentials

Services are already imported through the metadata import step and service credentials are already assigned. Services whose credentials are not configured in Business Manager are assigned credentials through code on run time.

To change service credentials:

Select Business Manager > Administration > Operations > Services

The Services screen appears.
Select Business Manager > Administration > Operations > Services > Credentials Tab

The Service Credentials screen appears.
Contact the Radial team for the Store ID and the service endpoint URL.
Change all the service URLs that apply to your integration with Radial as highlighted with the new one till SFCCT1 (Store Id).

Payment Methods Setup

Radial integrates with a number of payment methods.

To enable or disable payment methods, select:

Business Manager > Merchant Tools > Ordering > Payment Methods

In this example, a new Card Type has been added in Credit Card section for PLCC.

In the Card Number Verification field, change the Bin Range for the PLCC card for your site as provided by Radial.

Custom Site Preference Configuration

To configure custom preferences for your site, select:

Business Manager > Merchant Tools > Site Preferences > Custom Preferences

Because the metadata is already imported, you see the following preference groups:

Radial General
Radial Credit Card
Radial Tax
Radial Google Pay

Radial Risk Config
Radial After Pay
Radial Non OMS
Radial ROM
Radial Payments

Radial Service Retry
Radial Jobs
Radial Performance Testing

The following tables describe each Custom Preference Group.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial General	radialPTFStoreCode	Radial PTF Store Code	Radial Payment Solutions store code
	radialStoreAPIKey	Radial Store API Key	Radial Store API key provided for Radial Payment Solutions store
	enableRadialAVS	Enable Radial Address Validation Service	Enable Radial Address Validation Service
	avsMaxSuggestions	Radial AVS Max Suggestions	Maximum address suggestions returned by AVS service
	radialGCTenderType	Radial Gift Certificate Tender Type	Gift Certificate tender code of the service provider
	customerServiceEmail	Customer Service Email	Customer service email. Emails to the customer are sent from this email address.
	radialMailIds	Radial DL mail Ids	Mail is sent to Radial distribution list for any notifications.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Credit Card	radialCardRangePLCC	Radial PLCC Card Range	Private Level credit card bin range. Initial digits of the card to be configured to identify the card used in checkout flow as PLCC.
	radialNonceURL	Radial Nonce URL	Configure Radial nonce URL to get the nonce to be used further in tokenization.
	radialNonceCredentials	Radial Nonce Credentials	Radial Nonce credentials to be submitted with nonce URL. Must use the '\|' separator.
	radialPaymentJS	Radial Payment JavaScript	Radial Payment JavaScript URL
	retryAVSCount	Retry Count AVS/CSC Error	Retry count in case of an AVS CSC error in the checkout flow. Configure it to 0 if no need of retry. Configure it to max random number 999999, to prevent a customer from placing an order.
	enableAuthCaptureStorefront	Enable Auth Capture From Storefront	Enable authorization settlement of a credit card from the storefront.
	isRadial3DSEnabled	Enable Radial 3DS	Enable 3D Secure verification for a credit card while placing an order.
	radial3DSCards	Radial 3DS Cards	Radial supported cards for 3DS

Preference Group	Site Preference ID	Site Preference Name	Description
Radial PayPal	enablePayPalExpress	Enable PayPal Express	Enable the PayPal Express button on the cart page.
	redirectURLPayPal	Redirect URL PayPal	PayPal Sandbox URL where redirection happens
	enablePayPalSmart	Enable PayPal Smart Button	Enable the PayPal Smart Button on the cart page.
	paypalSmartScript	PayPal Smart Script	PayPal Smart Script to be loaded on cart page.
	paypalSmartSandboxKey	PayPal Smart Key	PayPal Smart Sandbox Key
	paypalSmartEnvironment	PayPal Smart Environment	PayPal Smart environment

Preference Group	Site Preference ID	Site Preference Name	Description
Radial TAX	radialTaxEnabled	Enable Radial Tax	Enable the Radial TAX API.
	radialTaxAdminOrigin	Admin Origin Address	The Tax Quote API expects the Admin Origin to be passed for each line item.
	radialTaxShippingOrigin	Shipping Origin Address	The Tax Quote API expects the shipping origin to be passed with each line item. If Radial Order Management is enabled, then the shipping origin is received from the Inventory details API response.
	defaultCountryOfOrigin	Default Country of Origin	Default Country of Origin to be passed in the TAX API if not available at product level

Preference Group	Site Preferences ID	Site Preference Name	Description
Radial Google Pay	radiaGpayGatewayInfo	Google Pay Gateway Info	Google Pay Gateway payment information
	radiaGpayMerchantInfo	Google Pay Merchant Info	Google Pay Merchant Information
	radialGooglePayScript	Google Pay Script	Google Pay Script
	radialGpayCards	Google Pay Cards	Google Pay Cards
	radialGpayEnvironment	Google Pay Environment	Google Pay Environment

Preference Group	Site Preference ID	Site Preference Name	Description
Radial RiskConfig	radialRiskScript	Radial Device Fingerprint Script	The Radial Risk JavaScript used to generate the Radial Device fingerprint. This script is also used in Risk assessment.
	isRiskInsightEnabled	Enable Risk Insight	Enable the Risk Insight Feature. Risk Insight is triggered after order creation and before Payment Authorization.
	riskEligibleMethods	Risk Insight Eligible Payment Methods	Eligible Payment methods for Risk Insight
	riskMediumBehavior	Risk Insight Medium Response Behavior	Risk Insight Medium behavior, Low or High.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial AfterPay	radialAfterPayUrl	After Pay URL	Radial Afterpay redirect URL
	afterpayMaxAmount	Afterpay Maximum Amount	After Pay Payment method maximum amount
	afterpayMinAmount	Afterpay Minimum Amount	After Pay Payment method minimum amount
	afterpayConfigExpiration	Afterpay Configuration Expiration	After Pay Configuration expired. A job is configured to update the configurations.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Non OMS	confirmFundDays	Confirm Funds Days	For a third-party OMS Settlement request. If the Order is older than configurable days, then the Confirm Funds API is triggered before settlement.
	radialWebHookCredentials	Public URL Credentials	The Public URL is set up with Basic Authentication.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial ROM	isRadialOMSEnabled	Enable Radial OMS	Enable Radial Order Management.
	radialOMSStoreCode	Radial OMS Store Code	Radial Order ManagementStore Code
	radialRomAPIKey	Radial OMS API Key	Radial Order ManagementAPI key for services
	radialCatalogID	Catalog ID Prefix	Radial Catalog Id Prefix. Sent in theItem master feed and to appended with the Item ID when calling ROM APIs. radialCatalogID + productID
	itemMasterClientId	Item Master Client Id	Item Master Client ID passed in the Item Master feed
	radialOrderIdPrefix	Order Id Prefix	Radial Order Management order ID prefix. In the Create Order API, this value is prefixed to SFCC order number.
	radialCustomerIdPrefix	Customer Id Prefix	Radial Order Management customer ID Prefix. In the Create Order API this value is prefixed to SFCC Customer ID.
	createOrderROMStorefront	Send Order to ROM From Storefront	Calls the Radial Create Order API from the Storefront. If disabled, you must configure a job to export the orders.
	isInventoryCheckEnabled	Enable Inventory Check Service	Real-time Inventory Check API. If enabled, an inventory check occurs before adding product to basket.
	isInventoryReservationEnabled	Enable Inventory Reservation	Enable the Radial Inventory reservation. Basket reservation occurs before creating the order.
	isInventoryDetailsEnabled	Enable Inventory Details Service	Enable the Radial Inventory Details API. This API is triggered from the shipping submit page. If returns the estimated delivery and shipping origin information.
	orderTrackingURL	Order Tracking URL	Order tracking URL.
	isOrderReturnEnabled	Return Order Enable	Enable the order return flow from the Storefront.
	isOrderCancelEnabled	Cancel Order Enable	Enable Cancel Order from the Storefront.
	isOrderUpdateEnabled	Update Order Enable	Enable Update Order from the Storefront.
	radialReturnReasons	Radial RMA return reasons	Return reasons to be configured.
	orderCancelReason	Radial Order Cancel reason	Order Cancel reasons to be configured.
	isISPUEnabled	Enable ISPU	Enable the In-Store Pickup feature.
	storeInventoryAvailable	Individual store inventory available	Determines if store inventory is available.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Payments	radialKlarnaScript	Klarna Script	Radial Klarna Script
	radialKlarnaVariables	Klarna Variables	Varibles needed in Klarna request
	radialVATRegistrationId	Open Invoice VAT Registration ID	VAT registration ID for Open Invoice payment method

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Service Retry	radialTimeoutCodes	Radial Timeout Codes	Radial timeout codes for services that require service retry
	retryCreditCardAuth	Retry Count Credit Card Auth API	Retry count for Radial Credit Card API for processor timeout error
	retryPayPalAPI	Retry Count PayPal API	Retry count to be configured for PayPal APIs
	retryGiftCardApi	Retry Count Gift Card Api API	Retry count for Radial Credit Card API for processor timeout error
	retryAfterPayApi	Retry Count Afterpay API	Retry Count for Afterpay API
	retryRedirectPaymentAPI	Retry Count Redirect Payment API	Retry Count for Payment Auth service for redirect payment providers
	retryPaymentStatusAPI	Retry Count Payment Status API	Retry Count for Payment Status API once returned from third-party payment page
	retryOpenInvoiceAPI	Retry Count Open Invoice API	Retry Count for Open Invoice API
	retryTaxAuth	Retry Count Tax Quote API	Retry Count for Tax API
	retryRiskAPI	Retry Risk API	Retry Count for Risk API
	retryCreateOrderAPI	Retry Create Order API	Retry Count for Create Order API
	retryAVSAPI	Retry Address Validation API	Retry Count for AVS API

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Jobs	itemMasterJobLastRunTime	Item Master Job Last Run Time	The last run time for theItem Master job. This preference is used to identify either ADD/Change behavior of the products from the last run.
	radialItemMasterDeptInfo	Item Master Department Info	Item Master Department Info
	facilityMasterJobLastRunTime	Store Feed last run time	The last run time for the store feed job.

Preference Group	Site Preference ID	Site Preference Name	Description
Radial Performance Testing	isPerformanceTestingEnabled	Enable Performance Testing	Determines if Performance Testing is enabled. If enabled, third-party payment redirection does not happen.
	perfTestDataPayPal	Test Data PayPal	PayPal test data to be provided during performance testing

Custom Code

Store Front Reference Architecture (SFRA) does not allow modification of the core cartridge to enable the LINK integration cartridge. Radial integration follows best practices recommended by Salesforce; therefore, no code changes are required for the default installation.