Set up payment methods

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

Most of the supported payment methods function out of the box once 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.

Before you begin

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:

In the Business Manager, go to Merchant tools > Ordering > Payment Methods.
In the Payment Methods overview, check the ID column to make sure that AdyenComponent and CREDIT_CARD are enabled.
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:

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

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.

For versions 23.1.0 or later, 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.
For versions 22.2.2 or earlier, you can only use your own Apple Pay certificate to set up Apple Pay. This integration is provided by Salesforce Commerce Cloud, and you can only enable the Apple Pay express checkout flow.

To set up Apple Pay using Adyen's Apple Pay certificate, you must have an SFRA integration version 23.1.0 or later.

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 don't need to add Apple Pay certificates in the Wallet section.

Apple Pay is set up in your integration after this step, you don't need to set up any additional configurations in your 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 Business Manager:

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

Step 3 (optional): Set up tokenization for Apple Pay

It is possible to tokenize shopper's payment details when accepting payments with Apple Pay. To enable tokenization, configure the following settings in the Business Manager:

Go to Merchant Tools > Site Preferences > Adyen Settings > Additional Settings.
Enable Apple Pay tokenization.
Go to Merchant Tools > Site Preferences > Order.
Enable Generate Customer No. for Guest Preferences.

Step 4: 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 5: Go live with Apple Pay

If your cartridge is on a version earlier than version 23.2.1, you cannot complete the steps to go live in the Business Manager. Instead of the steps below, follow the steps to go live with the Component.

To enable Apple Pay in the Live environment, you have to set up the domain association file. This can be done in the Business Manager on cartridge versions v23.2.1 or later:

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

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

This integration allows shopper to checkout only with Apple Pay express, where the Pay button is displayed on the product and checkout page.

Step 1: Enable Apple Pay

Before you begin to set up Apple Pay on the Web, make sure that we have your Apple merchant identifier and payment processing certificate.

Refer to Enable Apple Pay and follow the instructions to:

You do not need to follow the steps to register and validate your merchant domain or create a merchant identity certificate on the page.

Step 2: Set up Apple Pay in Salesforce Commerce Cloud

In the Business Manager, go to Merchant Tools > Site Preferences > Apple Pay.
In the Payment integration section, fill in the following fields:

Field	Description
Apple Pay Enabled?	Select the checkbox.
Apple Merchant ID	Enter your Apple Merchant ID (configurable in https://developer.apple.com/).
Apple Merchant Name	Your business name, for example COMPANY INC.. This name will be visible in the Apple Pay payment sheet.
Country Code	Enter your Country Code.
Merchant Capabilities	Select 3DS.
Supported Networks	Select the supported networks.
Redirect Pages to HTTPS?	Select the checkbox.
Use Commerce Cloud Apple Pay Payment API?	Select the checkbox.
Payment Provider URL	Use https://pal-test.adyen.com/pal/adapter/Demandware/authorise for Test or https://pal-live.adyen.com/pal/adapter/Demandware/authorise for Live.
Payment Provider Merchant ID	Enter your Adyen Merchant Account name.
API Version	Select the latest.
Use Basic Authentication?	Select the checkbox.
Payment Provider User	Your API credential (ws@Company.[YourCompanyAccount]) from the Adyen Customer Area. You can find this under Developers > API credentials.
Payment Provider Password	Your API credential password from the Adyen Customer Area. To find your password, go to Developers > API credentials and select the credential: ws@Company.[YourCompanyAccount]. You need to use the Basic auth password.
Use JWS?	Leave it unselected.
JWS Private Key Alias	Leave it empty.

Register Apple Sandbox/Production domain on the Domain Registration section of Salesforce Commerce Cloud.
In the Business Manager, go to Merchant Tools > Ordering > Payment Methods > DW_APPLE_PAY and set Payment Processor to Adyen_Component.

Step 3: Install the Salesforce Commerce Cloud Apple Pay plugin

Make sure you have access to the Salesforce Commerce Cloud GitHub community.
Download the Apple Pay cartridge (plugin-applepay) from the Salesforce Commerce Cloud GitHub repository.

If you get a 404 error, double-check your access to the Salesforce Commerce Cloud GitHub community.
In the Business Manager, install the Salesforce Commerce Cloud Apple Pay cartridge that you downloaded.
Add plugin_applepay after int_adyen_overlay to your cartridge path.
Remove the hooks.json file from inside the plugin_applepay cartridge, or customize the file to suit your use case.

For any questions regarding this integration, contact Salesforce Commerce Cloud directly.

Amazon Pay Express

Add Amazon Pay in your test Customer Area.

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 Business Manager:

Go to Merchant Tools > Site Preferences > Adyen Settings > Local Payment Methods.
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 Business Manager:

Go to Merchant Tools > Site Preferences > Adyen Settings > Local Payment Methods.
Enable Klarna Widget.

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 Business Manager:

Go to Merchant tools > Site Preferences > Adyen Settings > Card settings.
Select the Enable Credit card installments toggle.

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.

Select Add Rule.

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 don't need to configure it in the plugin afterwards.

To enable Google Pay in the Production environment:

Get your Google Merchant Id.
In the Business Manager, go to Merchant tools > Site Preferences > Adyen Settings.
Set your value for Google MerchantID.
Select Save.

PayPal

PayPal is enabled by default in the Test environment.

To enable PayPal in the Production environment:

Get your PayPal Merchant Id.
(Optional) In the src/cartridges/int_adyen_overlay/cartridge/adyenConstants/paymentMethodDescriptions.js cartridge file, adjust the Paypal payment method description displayed to your shoppers on the checkout page.

Next steps

required

Test your integration

Use our test card numbers to make test payments.

required

Configure your live account

Follow this checklist before you start accepting live payments.