Set up payment methods

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

Credit cards and local payment methods

After the metadata import, Adyen has been added as the payment processor for credit cards and local payment methods in the Business Manager. To make sure that this has been set up correctly:

  1. In the Business Manager, go to Merchant tools Ordering > Payment Methods.
  2. In the ID column, click CREDIT_CARD, and check that Payment Processor is set to ADYEN_CREDIT.  
  3. In the ID column, click Adyen, and check that Payment Processor is set to Adyen.  

Enable Mastercard 2-series BIN

Mastercard issues cards with either a 2-series or 5-series BIN. By default, the cartridge only supports a 5-series BIN. If you also want to accept payments from a 2-series BIN: 

  1. In the Business Manager, go to Merchant tools Ordering > Payment Methods.
  2. Click the Credit/Debit Cards button. This opens a window for managing credit/debit cards. 
  3. Select Master Card
  4. In the Card Number Verification box, enter 222100-272099510000-559999.
  5. Click Apply.  

Directory Lookup

With our Directory Lookup integration, the available local payment methods are shown directly in your checkout. After the metadata import, Directory Lookup is enabled by default. To check this: 

  1. In the Business Manager, go to Merchant tools > Site Preferences > Custom Preferences > Adyen.
  2. Make sure that Switch to directory lookup is set to Yes.

When Directory Lookup is disabled, the shopper is redirected to an Adyen hosted payment page to select their payment method. In this case, you can use the Payment selection field to specify whether the payment process takes place within a single page, or is split into several pages.

For a better shopper experience, we recommend that you keep Directory Lookup enabled.

Set up point of sale (POS)

Adyen's Terminal API allows your Salesforce Commerce Cloud stores to process payments via point-of-sale (POS) devices.

Adyen's Terminal API is not yet available for SFRA.

Before you begin to set up POS, make sure that you have imported the metadata, and set up the cartridge.

Step 1: Enable POS payments

  1. In the Business Manager, go to Merchant Tools > Ordering > Payment methods.

  2. Click AdyenPOS.

  3. Select Yes in the Enabled column.

  4. From the Payment Processor drop-down in the AdyenPOS Details section, select Adyen_POS.

Step 2: Configure services

  1. In the Business Manager, go to Administration > Operations > Services.

  2. In the Profile column next to AdyenPosPayment, click Adyen.  

  3. In the Name box, enter Adyen.

  4. In the Connection Timeout (ms) box, enter 100.000.

  5. Ensure that the Enable Circuit Breaker check box is not selected.

Step 3: Configure a terminal

  1. In the Business Manager, go to Merchant Tools > Site Preferences > Custom Preferences.

  2. Click Adyen.

  3. In the Adyen POS unique terminal ID box, enter the unique terminal ID of your Adyen POS terminal, for example: MX925-260193322.

    You can find this in the Adyen Customer Area, under Point-of-sale >Terminals

    The unique terminal ID = [Device model]-[Serial number]

    You can also find the serial number of your terminal: press 5 on the terminal, and then press . This opens the quick info menu, and displays the serial number.

  4. In the X-API-KEY of Web service box, enter your API key. You can find this in the Adyen Customer Area, under Account > Users > [your web service user] > API Key.

Step 4 (optional): Configure multiple terminals

To configure multiple terminals: 
  1. In the Business Manager, go to Merchant Tools > Site Preferences > Custom Preferences.

  2. Click Adyen.

  3. In the Terminal configuration JSON box, enter JSON objects for the different terminals. Use the following key-value pairs:
Key Value
POIID

The unique terminal ID, for example: MX925-260193322.  You can find this in the Adyen Customer Area, under Point-of-sale >Terminals.

The unique terminal ID = [Device model]-[Serial number]

Description Description of the terminal.
Store The name of the store for this terminal. You can specify your own store names. 

Make sure that you only change the values, and keep the keys (POIIDDescriptionStore) as they are.

[
   {
      "POIID" : "P400-1234",
      "Description" : "Terminal description",
      "Store" : "YourStore1"
   },
   {
      "POIID" : "P400-5678",
      "Description" : "Terminal description",
      "Store" : "YourStore2"
   }
]

Set up Apple Pay on the Web 

Salesforce Commerce Cloud provides 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.

Before you begin to set up Apple Pay on the Web, make sure that you registered an Apple Merchant ID and sent it to Adyen. For more information, refer to Enable Apple Pay.

To set up Apple Pay on the Web:

  1. In the 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 check box.
    Apple Merchant ID Enter your Apple Merchant ID (configurable in https://developer.apple.com/).
    Apple Merchant Name Enter your Apple Merchant Name (configurable in https://developer.apple.com/).
    Country Code Enter your Country Code.
    Merchant Capabilities Select 3DS.
    Supported Networks Select the supported networks.
    Redirect Pages to HTTPS? Select the check box.
    Use Commerce Cloud Apple Pay Payment API? Select the check box.
    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 check box.
    Payment Provider User

    Your web service (ws) user (ws@Company.[YourCompanyAccount]) from the Adyen Customer Area. You can find this under Account > Users.

    Payment Provider Password

    Your web service (ws) user password from the Adyen Customer Area. You can find this under Account > Users, by clicking the ws user:

    ws@Company.[YourCompanyAccount]

    Use JWS? Leave it unselected.
    JWS Private Key Alias Leave it empty.
  3. Register Apple Sandbox/Production domain on the Domain Registration section of Salesforce Commerce Cloud.
  4. In the Business Manager, go to Merchant Tools > Ordering > Payment Methods > DW_APPLE_PAY and set Payment Processor to ADYEN_CREDIT.

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

Set up Klarna, AfterPay, and RatePay open invoice

To set up open invoice methods:

  1. In the Business Manager, go to Merchant Tools > Site Preferences > Custom Preferences > Adyen.
  2. In the Open invoice white list methods box, enter a comma-separated list of open invoice methods that you want to enable. Possible values: 
    • klarna
    • ratepay
    • afterpay_default
    • afterpay_directdebit
  3. If you are using RatePay, enter in the RatePay ID box the unique RatePay ID provided by your RatePay integration consultant. 

Next steps

Test and go live

Test your integration and start processing live transactions.

link