Set up payment methods

You need to add payment methods to your Customer Area before you can add them to your Magento admin panel.

Once you have added the payment methods to your Customer Area, make sure to enable Alternative payment methods in the Magento admin panel in order to render local payment methods in your checkout.

Some payment methods require extra steps to enable. To find the section for setting up payment methods in Magento:

1. Log in to your Magento admin panel.
2. In the left navigation bar, go to Stores > Configuration. 
3. In the menu, go to Sales > Payment Methods.
4. Select Configure payment methods.

Donations

With our Giving feature, you can give shoppers the option to donate to a charity after they have placed an order. Make sure the charity is onboarded at Adyen before you configure this feature.

To configure donations using Giving:

1. In your Magento Admin panel, go to Sales > Payment Methods.

2. In the menu, go to Configure payment methods > Adyen Giving. Fill out the following fields:

   Field	Description
   Enabled	Select Yes to enable Giving.
   Charity name	Name of the charity displayed on the Adyen Giving component.
   Charity merchant account	Adyen merchant account name for the charity.
   Suggested donation amounts	Suggested amounts that the shopper can donate using the order currency, separated by commas. The minimum amount is the equivalence of 1 EUR in your selected currency.
   Charity description	Description of the charity.
   Charity website	Link to the charity website.
   Background image	Background image of the Adyen Giving component.
   Charity logo	Logo displayed on the Adyen Giving component.

3. In the Adyen Customer Area, go to Developers > *Additional data.

4. In the Card section, select Variant.

Alternative payment methods

Field	Description
Enabled	Select Yes.
Sort Order	The position of this payment method during checkout.
Store alternative payment methods	Select Yes to securely store the SEPA payment details of shoppers.
Token Type	Select CardOnFile, UnscheduledCardOnFile or Subscription, depending on how the token will be used. For more information, see our FAQ.

Klarna\Ratepay\Afterpay Settings

Enter the unique RatePAY ID provided by your Ratepay integration consultant.

Advanced settings

Setting	Description
Title	The title that indicates the alternative payment methods during the checkout.
Language locale	The language shown to the shopper during checkout. By default, this is the language of your shop in Magento.
ISO Country Code	Determine the payment methods shown to the shopper during checkout. By default, this depends on the billing address of the shopper, however you can override it here.

Country Specific Settings

Payment from Applicable countries

Possible values: All Allowed Countries – Allow credit card payments from all allowed countries. Specific Countries – Allow credit card payments only from countries specified in the Payment from Specific Countries field below.

API credit card payments

To set up credit card payments, select CreditCard API integration and fill out the following fields: 

Field	Description
Enabled	Select Yes to enable this payment method.
Title	The title that indicates this payment method during checkout.
Sort Order	The position of this payment method during checkout.
Credit Card Types	Select the credit card type(s) that you want to show during checkout.

From plugin version 7.3.1 and later, shoppers that use a co-branded credit card can choose with which credit card type they want to complete their payment. For this functionality to work, both types have to be enabled in Credit Card Types.

Advanced Settings

Field	Description
Enable Installments	Select Yes to enable installments for each credit card type.

Country Specific Settings

Payment from Applicable countries

Possible values: All Allowed Countries – Allow credit card payments from all allowed countries. Specific Countries – Allow credit card payments only from countries specified in the Payment from Specific Countries field below.

Apple Pay

The steps for adding Apple Pay depend on which version of the plugin you're using:

Testing

Use Apple's test card numbers to test your integration.

Card Type	Card number	Expiry date	CVC/CID
Discover	6011 0009 9446 2780	11/2022	111
Mastercard	5204 2452 5000 1488	11/2022	111
Visa	4761 1200 1000 0492	11/2022	533

For a full list of test cards and instructions how to add these to your test device, see Sandbox testing on Apple's Developer website.

Check the status of an Apple Pay test payment in your Customer Area > Transactions >  Payments.

Boleto

To set up Boleto, select Boleto integration, and fill out the following fields:

Field	Description
Enabled	Select Yes to enable this payment method.
Title	The title that indicates this payment method during checkout.
Sort Order	The position of this payment method during checkout.
Days for Delivery	The number of days to be added to the current date to set the delivery date.

Country Specific Settings

Payment from Applicable countries

Possible values: All Allowed Countries – Allow credit card payments from all allowed countries. Specific Countries – Allow credit card payments only from countries specified in the Payment from Specific Countries field below.

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

The steps for adding Google Pay depend on which version of the plugin you're using:

MOTO

To use MOTO, you need a MOTO merchant account. Follow these steps to request a merchant account.

After you create a MOTO merchant account, you can configure the MOTO payment method in your plugin.

1. Go to Stores > Configuration > Sales > Payment methods > Adyen Payments.
2. Go to the Configure payment methods section.
3. Select the MOTO accordion.
4. Set Enabled to Yes.
5. Add a line.
6. Fill in the MOTO merchant account as explained here. You can only process MOTO payments through your MOTO merchant account.
7. Enter the Client Key and the API key related to your MOTO merchant account.
8. Select the TEST or LIVE environment.
9. Save your configuration.

We recommend that you clean your cache.

To test MOTO:

1. In your Magento admin panel, go to Sales > Orders.
2. Select Create New Order > Create New Customer or select an existing customer.
3. Select a store, then select Add Products > Adyen MOTO.

PayPal

To connect your PayPal account to your integration, you have to grant third party permissions to Adyen in your PayPal Business account. You also have to enter your PayPal Merchant ID in the Adyen Customer Area.

To do this:

1. Set up third party API access on your PayPal account.
2. Get your PayPal Merchant ID.
3. Set up the PayPal payment method.

Pay by Link

Pay by Link lets you create an order and send an Adyen payment link directly to the shopper in the order confirmation email. This option is available for orders created from the Magento admin panel.

Pay by Link is available from plugin version 7.3.0 and later. In earlier versions, use Pay by Mail.

The orders created with Pay by Link are not finished until the shopper clicks the generated link and proceeds with the payment. If the shopper doesn't complete the payment, unfinished orders will be automatically closed by the plugin's cron.

Set up Pay by Link

To create payment links, make sure you have the Pay by Link user permissions set up in your Adyen Customer Area. You can also customize the Pay by Link theme from your Adyen Customer Area.

To set up Pay by Link in the Magento 2 plugin, select Adyen Pay by Link and fill out the following fields: 

Field	Description
Enabled	Select Yes to enable this payment method.
Title	The title that indicates this payment method during checkout.
Default days to expire payment links	How many days this payment link should be active. You can override this value when creating the payment link.
Sort Order	The position of this payment method during checkout.

Create a payment link

After you have set up Pay by Link, you can start creating payment links for admin orders.

1. In your Magento Admin panel, go to Sales > Orders > Create New Order > Create New Customer (or select an existing customer).
2. Select a store, and then Add Products.
3. Select Adyen Pay By Link as the payment method.
4. You can optionally enter a custom expiration date for this payment link.

Pay by Mail

Create an order and send an Adyen payment link directly to the shopper.

Pay by Mail has been replaced with Pay by Link in plugin version 7.3.0 and later.

Set up the Pay by Mail redirect page

To set up the page that your shopper is redirected to after they click the payment link, you need to create a skin in your Adyen Customer Area. Before you go live, you also need to publish the skin to live.

Set up and enable Pay by Mail

To set up Pay by Mail, select Pay by Mail integration and fill out the following fields: 

Field	Description
Enabled	Select Yes to enable this payment method.
Title	The title that indicates this payment method during checkout.
Sort Order	The position of this payment method during checkout.
Session Validity	How many days do you want this payment page to be active.
Skin Code	Code of the skin you want to use.
HMAC Key for Test	The HMAC key for the test platform linked to the skin.
HMAC Key for Live	The HMAC key for the live platform linked to the skin.

Use Pay by Mail

After you have set up Pay by Mail and the redirect page, you can start to use Pay by Mail.

1. In your Magento admin panel, go to Sales > Orders > Create New Order > Create New Customer (or select an existing) > Select a store > Add Products > Select Pay By Mail.

Set up In-Person Payments

You can also offer terminal payments for your customers for the endless aisle experience. An employee can place an order from the admin panel and send the payment to the selected terminal.

To set up In-person Payments, follow this checklist. To configure in-person payments in your Magento 2 store:

1. Go to Stores > Configuration.
2. In the menu, go to Sales > Payment Methods.
3. Go to Adyen Payments.
4. Select Configure payment methods.
5. In the Point of Sale integration, note the following fields:

Field	Description
Enabled	Select Yes to enable this payment method.
Title	The title of the payment method during checkout.
Sort Order	The position of the payment method during checkout.
Merchant Account	Cloud API Adyen merchant account name for the terminal payments.
Agreement Type	Select to use tokenization for terminal payments.
Store ID for Cloud API	(Optional) Limit the terminal selection to a specific store in that merchant account.
API key for Cloud API TEST	Your API key from Adyen test Customer Area.
API key for Cloud API LIVE	Your API key from Adyen live Customer Area.
Capture Delay	Select Yes to use manual capture.
Enable Installments	Select Yes to enable installments for each credit card type.