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 ID column, check that Payment Processor is set to Adyen_Component for AdyenComponent and CREDIT_CARD for credit cards.
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. There are two ways to set up Apple Pay for your plugin:
- Use Adyen's Apple Pay certificate: 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.
To set up Apple Pay using Adyen's Apple Pay certificate, you must have an SFRA integration v23.1.0 or later.
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://localhostto 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.
To enable Apple Pay in the Live environment:
- Go to 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.
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.
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 (optional)
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:
- Go to our Github link for Salesforce Commerce Cloud to create the required configuration value.
- In the Business Manager, go to Merchant tools > Site Preferences > Custom Preferences and enter the created value into the Credit Card Installments field. Leave the field empty if you're not using installments.
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.
- In the Business Manager, go to Merchant tools > Site Preferences > Adyen Settings.
- Set your value for PayPal MerchantID.
- Select Save.
- (Optional) In the
src/cartridges/int_adyen_overlay/cartridge/adyenConstants/paymentMethodDescriptions.jscartridge file, adjust the Paypal payment method description displayed to your shoppers on the checkout page.