Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

Set up the payment methods in Magento

Set up the payment methods you want you offer, and customize how they are shown to your shoppers during checkout.

Before you set up the payment methods in Magento, you need to add the payment methods that you want to offer your shoppers to your Customer Area.

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

For a list of all payment methods supported by the plugin, refer to Supported payment methods.

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.

API credit card payments

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

FieldDescription
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 TypesSelect 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.

Alternative payment methods

This needs to be enabled in order to render local payment methods.

Field Description
Enabled Select Yes. In our later plugin version 7.0.0, Apple Pay and Google Pay are rendered from the Alternative Payment Method list.
Sort Order The position of this payment method during checkout.
Store alternative payment methods Select Yes if you want to securely store the SEPA payment details of shoppers.

Klarna\Ratepay\Afterpay Settings

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

Advanced settings

SettingDescription
TitleThe title that indicates the alternative payment methods during the checkout.
Language localeThe 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.

Apple Pay

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

  1. Download and unzip the domain association file.
  2. Host the domain association file with the name apple-developer-merchantid-domain-association on each domain you want to use, under the following path:
    /.well-known/apple-developer-merchantid-domain-association
  3. Add Apple Pay as a payment method in your live Customer Area and provide the following information:

    • Your main website URL. For example https://www.mystore.com.
    • Other domains you use for your shop website. For example https://www.mystore1.com or https://www.mystore2.com.
    • Optional: Any additional shop websites.
  4. Make sure that Alternative payment methods are activated in your Magento configuration.

Testing

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

Card TypeCard numberExpiry dateCVC/CID
Discover6011 0009 9446 278011/2022111
Mastercard5204 2452 5000 148811/2022111
Visa4761 1200 1000 049211/2022533

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.

Google Pay

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

To set up Google Pay, it is enough to add it in your Customer Area. Google Pay is then rendered from the Alternative Payment Methods list.

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.

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 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.

To set up Pay by Link, 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.

Adyen Giving

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 payment method.

To configure this payment method, you need to have Euro selected as an allowed currency in your configuration. To do this:

  1. In your Magento Admin panel, go to Stores > Configuration.
  2. In the menu, go to General > Currency Setup.
  3. Under Allowed Currencies select Euro. Save your settings by selecting Save Config.
  4. You can set currency rates by going to Stores > Currency Rates.

To set up Adyen 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 this payment method.
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.
  1. In the Adyen Customer Area, go to Developers > Additional data.
  2. In the Card section, select the Variant checkbox.

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.

MOTO

If you want to use MOTO, contact our Support Team.

Once our team confirms that MOTO has been set up for your account, you can start to use MOTO. Make sure you have created a separate store view to manage your MOTO account.

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

Next steps