Skip to main content

Online payments

Salesforce Commerce Cloud

Last updated: 09-Sep-2022
Rate this article:

Overview

Commerce Cloud is a Software-as-a-Service ecommerce solution provided by Salseforce, one of the leading CRM solutions. 

Given that Commerce Cloud is a cloud-based solution, this frees up business from implementing a technical roadmap for managing scaling, upgrades or integrations with other services. 

The Verifone Link Cartridge facilitates the integration between a Commerce Cloud Storefront and the Verifone eCommerce platform, by using the Hosted Checkout. 

Prerequisites

Prior to installation, the following prerequisites must be met by the merchant:

  • Either a Commerce Storefront Reference Architecture (SFRA) 6.0 or Site Genesis website.

Prerequisites for manual installation:

  • Nodejs version 10.20.1 for compiling frontend code as well as running the testing automation.
  • A way to upload the code to the SFCC instance WebDAV (Example: VS code with Prophet Debugger or Eclipse with UXStudio extension).
Prerequisites related to using Verifone Hosted cart in conjunction with the Salesforce Commercial Cloud cartridge:
  • The user that will be utilized in the plugin configuration needs at least one of the following roles assigned: Merchant Supervisor/ Merchant Cashier (in order to check the roles assigned to your user, log in to Verifone Central using the URL you received in your welcome emails and go to Administration → Users)
  • You will need to generate a Secure Card Capture key on the organization your user is associated to, in Verifone Central.

To start accepting eCommerce transactions, you need to generate a Secure Card Capture Key.

Manual Installation steps

Compiling Storefront Code

After downloading the package, execute the npm install or yarn install files in a console. Once this step is performes, execute the npm run build or yarn build files to compile the storefront code.

Upload Cartridges

Upload the Verifone cartridges to the sandbox using WebDAV client (for example: VS Code, UX Studio for Eclipse, Web SCP). For the SFRA storefront the required cartridges are bm_verifone, int_verifone, int_verifone_sfra and verifone_sfra_changes. For the Sitegenesis storefront the required cartridges are bm_verifone, int_verifone, int_verifone_sg and verifone_sg_changes.

Setup Cartridge Path

  1. Navigate to Business Manager > Administration > Sites > Manage Sites.
  2. Select the site you want to edit.
  3. Select the Setting tab.
  4. Add the cartridges to the left side of the cartridge path.
  5. For SFRA add verifone_sfra_changes:int_verifone_sfra:int_verifone.
  6. For Sitegenesis add verifone_sg_changes:int_verifone_sg:int_verifone.
  7. After configuring the site path, return to Business Manager > Administration > Sites > Manage Sites.
  8. Select business manager link.
  9. Select the Setting tab.
  10. Add the bm_verifone cartridges to the left side of the cartridge path.

Import Metadata

  1. Create a zip archive of the metadata folder located in the package.
  2. Go to Business Manager > Administration > Site Development > Site import & export.
  3. Upload the metadata zip file using form.
  4. Select the uploaded file.
  5. Click on the Import button.
  6. Click on the Ok button, when it appears.
  7. Wait for import to conclude successfully.

Cartridge Configuration

General settings

Verifone Preferences 1

The available options are:

  • Enable - Yes/No: Turn on the Verifone payment processing on the Checkout page.
  • Environment - Allow switching between production and test modes.

You can enable the test mode by checking the Enable test mode box so you can use the Verifone test environment to test your integration. Before testing, you need to have an account set up in the test environment and to use the information from your test account (user ID, API key, organization ID). Test cards can be located in this article.

  • Geographic region: Enable the option to switch between the three available regions: EMEA, North America and New Zealand.
  • API Key: The value of the API Key you created in Verifone Central.
  • API Secret: The user ID on which the API key is created.
  • Entity ID: TheEntity ID or Organisation ID can be found in Verifone Central, under Administration  Organisations. There might be several organisations available as part of your account hierarchy. When filling in the organisation ID here, please make sure you pick the ID of the organisation connected to your Payment Provider Contract. You can check that by clicking on the organisation and searching for the associated payment provider contracts.

Accepted payment methods

Commerce Cloud accepts the following payment methods:

  • Credit card
  • Apple Pay
  • Google Pay
  • PayPal

Card settings

Card Settings

  • Card enabled: Yes/No - enable payment by Credit Card for shoppers.
  • Dynamic descriptor: The value in this parameter is displayed on the cardholder's bank statement.
  • CVV required: Force the collecting of the CVV from the shopper on the payment page.
  • Payment Contract ID: The payment contract can be found in Verifone Central, under Administration → Payment Contract Providers. The 'Payment Provider Contract ID' listed is the Payment Contract ID required for the plugin configuration. 
  • 3DS enabled: Enable/disable PSD 3DS.
  • 3DS Contract ID: The 3DS Contract ID can be found in Verifone Central, under Administration → 3-D Secure Provider Contracts. Select the 3DS facility required. The ‘3-D Secure Contract ID’ listed is the 3DS Contract ID needed for the plugin configuration.
  • Authorization type: Select the authentication type for the transactions.
  • Enable instalments: Enable instalments for the Israel market.

Instalments 

Enable Installment

If you are using Verifone as a gateway services provider in conjunction with an acquiring contract with from ABS, set the Enable ABS Installments option (valid only for Israel).

This will allow you to set up the transaction value intervals and the maximum allowed number of instalments. 

Apple Pay

Apple Pay

  • ApplePay enabled: Enable Apple Pay as a payment method for shoppers.
  • ApplePay Dynamic Descriptor: The value in this parameter is displayed on the cardholders bank statement.
  • ApplePay Authorization Type: Select the authentication type for the transactions .
  • ApplePay Payment Contract ID: The payment contract can be found in Verifone Central, under Administration → Payment Contract Providers. The 'Payment Provider Contract ID' listed is the Payment Contract ID required for the plugin configuration. 
  • 3DS Enabled: Enable/disable PSD 3DS.
  • 3DS Contract ID - The 3DS Contract ID can be found in Verifone Central, under Administration → 3-D Secure Provider Contracts. Select the 3DS facility required. The ‘3-D Secure Contract ID’ listed is the 3DS Contract ID needed for the plugin configuration.
  • 3DS SCA Compliance Level: Strong Customer Authentication (SCA) compliance level. Determines the rules of 3DS usage.

Google Pay

GooglePay

  • GooglePay Enabled: Enable Google Pay as a payment method for shoppers.
  • GooglePay Dynamic Descriptor: The value in this parameter is displayed on the cardholder's bank statement.
  • GooglePay Authorization Type: Select the authentication type for the transactions.
  • GooglePay Payment Contract ID: The payment contract can be found in Verifone Central, under Administration → Payment Contract Providers. The 'Payment Provider Contract ID' listed is the Payment Contract ID required for the plugin configuration. 
  • 3DS Enabled: Enable/disable PSD 3DS.
  • 3DS Contract ID - The 3DS Contract ID can be found in Verifone Central, under Administration → 3-D Secure Provider Contracts. Select the 3DS facility required. The ‘3-D Secure Contract ID’ listed is the 3DS Contract ID needed for the plugin configuration.
  • 3DS SCA Compliance Level: Strong Customer Authentication (SCA) compliance level. Determines the rules of 3DS usage.

PayPal

PayPal

  • PayPal Enabled: Enable PayPal as a payment method for shoppers.
  • PayPal Dynamic Descriptor: The value in this parameter is displayed on the cardholder's bank statement.
  • PayPal Capture now: Select the authentication type for the transactions.
  • PayPal Payment Contract ID: The payment contract can be found in Verifone Central, under Administration → Payment Contract Providers. The 'Payment Provider Contract ID' listed is the Payment Contract ID required for the plugin configuration. 
  • PayPal Landing Page: Additional merchant options to control the appearance of PayPal's landing page.
Rate this article:

Need help?

Do you have a question? On our Support page you will find a list with answers to frequently asked questions.
Did not find the answer you are looking for? Please contact us. We are happy to help.

Logo of Verifone