Plugins-2 icon

Set up payment methods

Configure the payment methods that you want to offer in your Salesforce Commerce Cloud store.

Salesforce SFRA
Salesforce SiteGenesis
/user/pages/filters/salesforce-payments/sfra/visual/stack-of-credit-cards.svg

Set up payment methods

Most of the supported payment methods function out of the box with after you have added them to your Customer Area. On this page you can find the instructions for setting up the payment methods that require extra steps to enable.

Start integrating with Salesforce SFRA cartridge

Choose your version
24.4.0

Requirements

After the metadata import, Adyen has been added as the payment processor for credit cards and for the local payment methods that have been set up for your merchant account.

To make sure that this has been set up correctly:

  1. In the Salesforce Business Manager, go to Merchant toolsOrdering > Payment Methods.
  2. In the Payment Methods overview, check the ID column to make sure that AdyenComponent and CREDIT_CARD are enabled.
  3. Under Details, set Payment Processor to Adyen_Component for both types.

Arrange payment methods

Payment methods are shown based on a shopper's order amount, currency and shipping country. The order in which the payment methods are displayed to shoppers can be changed per country in the Customer Area:

  1. Go to Settings > Checkout Settings.
  2. Drag the payment methods in the order that you want to display them.

Adjust payment method descriptions

You can adjust the payment method descriptions that are displayed to your shoppers on the checkout page.

The payment method descriptions used by the cartridge are in the paymentMethodDescriptions.js file. To change the description for a payment method:

  1. Go to src/cartridges/int_adyen_SFRA/cartridge/adyen/config/adyenConstants/paymentMethodDescriptions.js.
  2. Add the payment description that you want to display to your shoppers.

Apple Pay

Salesforce Commerce Cloud provides the integration with Apple Pay on the Web, where Adyen is used as one of the payment facilitators to accept Apple Pay tokens and process them.

There are two ways to set up Apple Pay:

  • Use Adyen's Apple Pay certificate (recommended): This integration is provided by the Adyen cartridge. This option is a faster way to add Apple Pay to your integration and requires less configuration.
  • Use your own Apple Pay certificate: This integration is provided by Salesforce Commerce Cloud, and you can only enable the Apple Pay express checkout flow.

This integration allows shoppers to checkout with Apple Pay or Apple Pay express, where the Pay button is displayed on the checkout and mini-cart page.

Step 1: Enable Apple Pay

Add Apple Pay in your test Customer Area.

  • You will be asked for Shop websites: your website URLs, for example https://www.mystore.com. If you add more than one, separate them with a comma.
  • You cannot use http://localhost to test.

You do not need to add Apple Pay certificates in the Wallet section.

Apple Pay is set up in your integration after this step, you do not need to set up any additional configurations in your Salesforce Business Manager.

Step 2 (optional): Set up Apple Pay Express in Salesforce Commerce Cloud

The integration supports Apple Pay express payment method, where the Pay button is displayed on the cart page and mini cart view. To enable Apple Pay Express, configure the following settings in the Salesforce Business Manager:

  1. Go to Merchant Tools > Site Preferences > Adyen Settings > Express Checkout.
  2. Enable Apple Pay Express.

Step 3: Test Apple Pay

Use Apple's test card numbers to test your integration. Refer to Apple Documentation for a full list of test cards and instructions on how to add those to your test device.
You can check the status of an Apple Pay test payment in Customer Area > Transactions > Payments.

Step 4: Go live with Apple Pay

To enable Apple Pay in the Live environment, set up the domain association file in the Salesforce Business Manager:

  1. Go to Merchant Tools > Site Preferences > Adyen Settings > Local payment method settings.
  2. Set the input field for the Apple Pay domain association file:
  3. Go to Merchant Tools > SEO > Aliases.
  4. Define the following alias so that the domain association file is externally accessible in the path specified by Apple:

    Define the alias
    Expand view
    Copy link to code block
    Copy code
    Copy code
    "__version": "1",
    "settings": {
    "http-host": "your.sandbox-domain.com",
    "https-host": "your.sandbox-domain.com",
    "default" : "true",
    "site-path" : "/"
    },
    "your.sandbox-domain.com": [{
    "locale": "YOUR_LOCALE",
    "if-site-path" : "/"
    }
    ]

    The "locale" must be one that is enabled in your sandbox.

Amazon Pay Express

To enable Amazon Pay:

  1. Add Amazon Pay in your test Customer Area.
  2. Register for Amazon Pay.
  3. Create an Amazon Pay Sandbox test buyer account.
  4. Get your PublicKeyId and give information to Adyen.

The integration supports Amazon Pay Express payment method, where the Amazon Pay button is displayed on the cart page and mini cart view. To enable Amazon Pay Express, configure the following settings in the Salesforce Business Manager:

  1. Go to Merchant Tools > Site Preferences > Adyen Settings > Local Payment Methods.
  2. Enable Amazon Pay Express.

Klarna payment widget

Add Klarna in your test Customer Area.

Optionally, you can enable the Klarna payment widget that shows shoppers an embedded widget on the Checkout page instead of a redirect. To enable the Klarna widget, configure the following settings in the Salesforce Business Manager:

  1. Go to Merchant Tools > Site Preferences > Adyen Settings > Local payment method settings.
  2. Enable Klarna Inline Widget.
  3. Select Save changes.

Credit card installments

Credit card installments are optionally available in some countries. To learn more about their availability, see Credit card installments.

To configure credit card installments, configure the following settings in the Salesforce Business Manager:

  1. Go to Merchant tools > Site Preferences > Adyen Settings > Card settings.

  2. Select the Enable Credit card installments toggle.

  3. Fill the following fields to configure an installment rule. You can configure a different installment rule for each card type.

    Field Description
    Minimum Amount Set the minimum installment amount for each credit card type.
    Number of Installments Set the number of installments you want to offer for each credit card.
    Allowed Credit Card Types Set the credit card types that you want to allow installments for.
    Select to delete an installment rule.
  4. Select Add Rule, then select Save Changes.

Gift cards

If you want to accept gift card payments, contact our Support Team.

Once our team confirms that gift card payments have been set up for you account, you can start to accept gift cards in your checkout.

Google Pay

Enable Google Pay in your test Customer Area. You do not need to configure it in the plugin afterwards.

To enable Google Pay in the live environment:

  1. Get your Google Merchant Id.
  2. In the Salesforce Business Manager, go to Merchant tools > Site Preferences > Adyen Settings > Local payment method settings.
  3. In the Google Merchant ID field, enter your merchant ID.
  4. Select Save Changes.

PayPal

To enable PayPal in the Production environment, get your PayPal Merchant Id, and add PayPal to your Customer Area.

If you and your shopper are both located in the United States, Venmo will be shown as a payment option. You can hide Venmo if you do not want to offer it as a payment method to your shoppers.

Tokenization with PayPal requires additional configuration on our side. If you have enabled storing payment details of your shoppers when you set up the plugin, reach out to our Support Team to enable this functionality.

Express checkout

This version of the cartridge uses a new PayPal express checkout flow. If you have already integrated with PayPal express using the old integration, reach out to our Support Team.

You can enable express checkout with PayPal to offer faster checkout experiences to your returning shoppers. Our cartridge supports displaying the option to use express checkout on your cart and mini-cart pages.

To enable PayPal express:

  1. In your Business Manager, go to Merchant Tools > Site Preferences > Adyen Settings > Express Checkout.
  2. Select the toggle to enable PayPal.
  3. If you want to display an order review page that contains the details of the payment and shipment to your shoppers, select the Show shopper order review page toggle.
  4. Select Save.

Next steps