--- title: "Set up payment methods" description: "Configure the payment methods that you want to offer in your Salesforce Commerce Cloud store." url: "https://docs.adyen.com/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods" source_url: "https://docs.adyen.com/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods.md" canonical: "https://docs.adyen.com/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods" last_modified: "2023-12-13T10:54:00+01:00" language: "en" --- # Set up payment methods Configure the payment methods that you want to offer in your Salesforce Commerce Cloud store. [View source](/plugins/salesforce-commerce-cloud/sfra/set-up-payment-methods.md) ## Salesforce SFRA cartridge Set up payment methods ### Before You Begin ## Requirements After the [metadata import](/plugins/salesforce-commerce-cloud/sfra/install-the-cartridge-and-import-the-metadata), 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](/payment-methods/add-payment-methods). To make sure that this has been set up correctly: 1. In the Salesforce Business Manager, go to **Merchant tools** > **Ordering** > **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](https://ca-test.adyen.com/): 1. Go to **Settings** > **Checkout Settings**. 2. Drag the payment methods in the order that you want to display them. ### Add Description ## 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](https://developer.apple.com/documentation/applepayjs), 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**: This integration is provided by the Adyen cartridge. * **Use your own Apple Pay certificate**: This integration is provided by Salesforce Commerce Cloud, and is limited compared to using Adyen's Apple Pay certificate. This option only lets you enable Apple Pay for express checkout. We strongly recommend to use Adyen's Apple Pay certificate, because this option and requires less configuration steps. ### Tab: Use Adyen's Apple Pay certificate This integration allows shoppers to check out with Apple Pay or Apple Pay express, where the **Pay** button can be displayed on the product detail, or cart and mini-cart pages. ### Step 1: Enable Apple Pay In your test [Customer Area](https://ca-test.adyen.com/), [add Apple Pay](/payment-methods/add-payment-methods). * 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 You can offer your shoppers the option to use express checkout on the product detail, cart, and mini-cart pages. To enable Apple Pay Express: 1. In your Salesforce Business Manager, go to **Merchant Tools** > **Site Preferences** > **Adyen Settings** > **Express Checkout**. 2. Under **Apple Pay Express**, select the toggle to enable express checkout on the product detail, cart, mini-cart, and shipping pages. 3. Select **Save Changes**. ### Step 3: Test Apple Pay Use Apple's test card numbers to test your integration. Refer to [Apple Documentation](https://developer.apple.com/apple-pay/sandbox-testing/) 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](https://ca-test.adyen.com/) > **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: * Download and unzip the Apple Pay [domain association file from our Apple Pay docs](/payment-methods/apple-pay/web-component/?tab=adyen-certificate-live_1). You do not have to follow the subsequent steps on the page. 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** ```json "__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. ### Tab: Use your own Apple Pay certificate This integration allows shopper to check out only with Apple Pay express, where the **Pay** button is displayed on the product and checkout page. Adyen does not offer troubleshooting support when you set up Apple Pay using the integration provided by Salesforce Commerce Cloud. For any questions about this integration, contact Salesforce Commerce Cloud directly. ### Step 1: Install the Salesforce Commerce Cloud Apple Pay plugin 1. Make sure that you have access to the [Salesforce Commerce Cloud GitHub community](https://documentation.b2c.commercecloud.salesforce.com/DOC1/topic/com.demandware.dochelp/content/b2c_commerce/topics/sfra/b2c_sfra_setup.html). 2. Download the Apple Pay cartridge (**plugin-applepay**) from the Salesforce Commerce Cloud [GitHub repository](https://github.com/SalesforceCommerceCloud/plugin-applepay). If you get a 404 error, double-check your [access](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2Fcontent%2Fb2c_commerce%2Ftopics%2Fsite_development%2Fb2c_github_repo_access.html\&anchor=github_repo) to the Salesforce Commerce Cloud GitHub community. 3. In the Salesforce Business Manager, install the Salesforce Commerce Cloud Apple Pay cartridge that you downloaded. 4. Add `plugin_applepay` **after** `int_adyen_SFRA` to your [cartridge path](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge?plugin=Salesforce%20SFRA\&integration=cartridge#step-1-set-up-the-cartridge-path). 5. Remove the `hooks.json` file from inside the `plugin_applepay` cartridge, or [customize the file](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FDWAPI%2Fscriptapi%2Fhtml%2Fapi%2Fclass_dw_extensions_applepay_ApplePayHooks.html) to suit your use case. ### Step 2: 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 [Apple Pay certificate](/payment-methods/apple-pay/apple-pay-certificate) and follow the instructions to: 1. [Create your merchant identifier](/payment-methods/apple-pay/apple-pay-certificate/web#create-merchant-identifiers). 2. Log in to your Apple Developer account at  and follow the instructions to [enable Apple Pay capabilities](https://developer.apple.com/help/account/manage-identifiers/enable-app-capabilities#enable-apple-pay). 3. [Create a payment processing certificate](/payment-methods/apple-pay/apple-pay-certificate/web#create-payment-processing-certificate). You do not need to follow the steps to [register and validate your merchant domain](/payment-methods/apple-pay/apple-pay-certificate/web#register-merchant-domain) or [create a merchant identity certificate](/payment-methods/apple-pay/apple-pay-certificate/web#create-merchant-identity-certificate) on the page. ### Step 3: Set up Apple Pay in Salesforce Commerce Cloud 1. In the Salesforce Business Manager, go to **Merchant Tools** > **Site Preferences** > **Apple Pay**. 2. 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](https://developer.apple.com/design/human-interface-guidelines/apple-pay#Customizing-the-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](https://ca-test.adyen.com/). You can find this under **Developers** > **API credentials**. | | Payment Provider Password | Your API credential password from the Adyen [Customer Area](https://ca-test.adyen.com/). 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. | 3. [Register Apple Sandbox/Production domain](https://help.salesforce.com/s/articleView?id=cc.b2c_register_an_applepay_domain.htm\&type=5) on the **Domain Registration** section of Salesforce Commerce Cloud. 4. In the Salesforce Business Manager, go to **Merchant Tools** > **Ordering** > **Payment Methods** > **DW\_APPLE\_PAY** and set **Payment Processor** to **Adyen\_Component**. ### Amazon Pay ## Amazon Pay Express To enable Amazon Pay: 1. [Add Amazon Pay](/payment-methods/add-payment-methods) in your test [Customer Area](https://ca-test.adyen.com/). 2. [Register for Amazon Pay](/payment-methods/amazon-pay/web-component/#step-1). 3. [Create an Amazon Pay Sandbox test buyer account](/payment-methods/amazon-pay/web-component/#step-2). 4. [Get your PublicKeyId and give information to Adyen](/payment-methods/amazon-pay/web-component/#step-3). 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. Under **Amazon Pay Express**, select the toggle to enable express checkout on cart and mini-cart pages. 3. Select **Save Changes**. ### Klarna ## Klarna payment widget [Add Klarna](/payment-methods/add-payment-methods) in your test [Customer Area](https://ca-test.adyen.com/). Optionally, you can enable the [Klarna payment widget](https://docs.klarna.com/klarna-payments/integrate-with-klarna-payments/step-2-check-out/21-display-klarna/) 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 Cards ## Credit card installments Credit card installments are optionally available in some countries. To learn more about their availability, see [Credit card installments](/payment-methods/cards/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](/payment-methods/gift-cards), contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other). 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 For Google Pay, you can offer the option to use express checkout to your shoppers on the prdouct detail, cart, or mini-cart pages. Enable Google Pay in your test [Customer Area](https://ca-test.adyen.com/). You do not need additional configuration for the standard Google Pay flow. To enable Google Pay express: 1. In your Salesforce Business Manager, go to **Merchant tools** > **Site Preferences** > **Adyen Settings** > **Express checkout**. 2. Under **Google Pay Express**, select the toggle to enable express checkout on the product detail, cart, mini-cart, and shipping pages. 3. Select **Save Changes**. To enable Google Pay in the live environment: 1. Get your [Google Merchant Id](/payment-methods/google-pay/web-drop-in#before-you-go-live). 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](/payment-methods/paypal/setup-paypal-direct-merchants), 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](/payment-methods/paypal#venmo) will be shown as a payment option. You can [hide Venmo](/payment-methods/paypal/web-component#hide-venmo) if you do not want to offer it as a payment method to your shoppers. [Tokenization](/online-payments/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](/plugins/salesforce-commerce-cloud/sfra/set-up-the-cartridge/), reach out to our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) 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](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other). You can enable [express checkout](/payment-methods/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. Under **PayPal Express**, select the toggle to enable express checkout on the product detail, cart, mini-cart, and shipping pages. 3. If you want to display an [order review page](/payment-methods/paypal/web-component/express-checkout/?tab=review-page-advanced_2#review-page) that contains the details of the payment and shipment to your shoppers, select the **Order review page** toggle. 4. Select **Save Changes**. ![](/user/pages/filters/salesforce-payments/sfra/visual/stack-of-credit-cards.svg) ## Next steps [required](/plugins/salesforce-commerce-cloud/sfra/go-live-checklist) [Configure your live account](/plugins/salesforce-commerce-cloud/sfra/go-live-checklist) [Follow this checklist before you start accepting live payments.](/plugins/salesforce-commerce-cloud/sfra/go-live-checklist)