---
title: "Set up payment methods"
description: "Set up the payment methods you want you offer, and customize how they are shown to your shoppers during checkout."
url: "https://docs.adyen.com/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce"
source_url: "https://docs.adyen.com/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce.md"
canonical: "https://docs.adyen.com/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce"
last_modified: "2025-07-23T11:56:00+02:00"
language: "en"
---

# Set up payment methods

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

[View source](/plugins/adobe-commerce/set-up-the-payment-methods-in-adobe-commerce.md)

## Requirements

Before you can add payment methods to your Adobe Commerce admin panel, you need to [add payment methods to your Customer Area](/plugins/adobe-commerce/supported-payment-methods#add-payment-methods-to-your-account).

For a list of all payment methods supported by the plugin, refer to [Supported payment methods](/plugins/adobe-commerce/supported-payment-methods).

## Enable payment methods in Adobe Commerce

When you have added the payment methods to your Customer Area, enable payment methods in the Adobe Commerce admin panel in order to render the payment methods in your checkout.

1. In your Adobe Commerce admin panel, go to **Stores** > **Configuration**.
2. In the menu, go to **Sales** > **Payment Methods**.
3. Select **Configure** next to **Adyen Payments**.
4. Go to **Accepting payments** > **Payment methods**.
5. Set the **Payment methods enabled** field to **Yes** to retrieve and enable all payment methods you added in your Customer Area.

After you have retrieved all payment methods from your Customer Area, you can start accepting and processing payments.

Some payment methods additional required and optional configuration options. The sections below explain these additional configurations.

## Card payments

Optionally, you can configure additional settings for card payments:

| Field                                               | Description                                                                                                                                                               |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Show holder name field for card payment methods** | Select **Yes** to allow shoppers to enter the cardholder's name during checkout. If you support Visa, you must set this field to **Yes**.                                 |
| **Holder name required**                            | Select **Yes** to make the holder name field a required field. If you support Visa, you must set this field to **Yes**.                                                   |
| **Enable installments**                             | Select **Yes** to enable installments for each credit card type. If you enable installments, you have to [set up installments for each credit card](#installments-setup). |
| **Send level 2/3 additional data for credit card**  | Select **Yes** to send [level 2/3 additional data](/payment-methods/cards/enhanced-scheme-data) for credit card payments.                                                 |
| **Click to Pay Enabled**                            | Select **Yes** to allow shoppers to pay with [Click to Pay](/payment-methods/cards/click-to-pay/).                                                                        |

### Installments setup

[Credit card installments](/payment-methods/cards/credit-card-installments) are available in a limited number of countries/regions.

You can set up installment rules for each credit card type. Next to **Installments**, fill out the following fields:

| 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.     |
| **Action**                    | Select **to delete an installment rule.                                |

## Alternative payment methods

| Field                                 | Description                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Apple Pay domain association file** | The Apple Pay domain association file. You can select **Download** to download the file.                                                                                                                                                                                                                                                                                                      |
| **RatePay Device Ident Sld**          | Enter the unique RatePay ID provided by your RatePay integration consultant.                                                                                                                                                                                                                                                                                                                  |
| **Refund strategy for gift card**     | If you accept gift card payments, you can set a refund strategy for cases when the gift card was used with another payment method to complete the payment. Possible values:* **Refund from first payment first*** **Refund from last payment first*** **Refund based on ratio**: The refunds are split between the different payment methods used to complete a payment based on their ratio. |
| **ISO country code**                  | Determine the payment methods shown to the shopper during checkout. By default, this depends on the billing address of the shopper, you can override it here. Format: the two-letter [ISO-3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. Exception: **QZ** (Kosovo).                                                                                         |
| **Language locale**                   | The language shown to the shopper during checkout. By default, this is the language of your shop in Adobe Commerce.                                                                                                                                                                                                                                                                           |
| **Boleto Types**                      | Set to the Boleto payment method variant you selected in your Adyen Customer Area when adding Boleto.                                                                                                                                                                                                                                                                                         |
| **Boleto Days for Delivery**          | The number of days to be added to the current date to set the delivery date.                                                                                                                                                                                                                                                                                                                  |

For headless integrations, there are [additional setup steps for gift card payments](/plugins/adobe-commerce/headless-integration#gift-card-payments).

## Online checkout

Optionally, you can configure settings to customize your checkout:

| Field                                               | Description                                                                                                           |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Payment method rendering in checkout**            | Set to **Logo + Title** if you want to display payment methods with their logo to your shoppers on the checkout page. |
| **Checkout return path**                            | Enter the path your shoppers will be returned to after being redirected to a payment page.                            |
| **House number in checkout (address street field)** | Select which address line to be used for your shoppers to input their house number.                                   |

## Headless integration

If you have a [headless integration](/plugins/adobe-commerce/headless-integration), you can configure the following settings:

| Field                              | Description                                                                                                                                                                                                                                     |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Payment Origin URL**             | By default, this is set to the Adobe Commerce store base URL. If you have a different URL for your front-end application, set to the origin URL of the page that you are loading the 3D Secure Component from.                                  |
| **Payment Return URL**             | The URL your shoppers are returned to after being redirected to complete a payment. The default value is **YOUR\_MAGENTO\_BASE\_URL/checkout/cart**.                                                                                            |
| **Customer Success Redirect Path** | The path to the success page your shoppers will be redirected to following a successful payment. If set, this will add the Order Increment ID as a query parameter. The default value is **YOUR\_MAGENTO\_BASE\_URL/checkout/onepage/success**. |

## Express payments

If you use our [Express Checkout module](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce/#use-express-checkout) to enable express checkout, be aware of the following configuration aspects:

* You can configure where to [show the express payment methods](/payment-methods/express-checkout/#show-express-payment-methods):

  * **Product view**
  * **Cart Page**
  * **Minicart**
  * **Shipping Page**

* For Apple Pay express payments, you can configure the [button color](https://developer.apple.com/design/human-interface-guidelines/apple-pay#Button-styles).

* For PayPal express payments, you need to check the configuration for whether the shopper's phone number in the checkout address form is required or optional. This configuration must be the same in both your PayPal Business account and in Adobe Commerce. There can be a problem with order creation if there is a mismatch where Adobe Commerce requires the shopper's phone number, but PayPal Express did not return it because it was configured as optional in the PayPal Business account.

## PayPal

To set up PayPal in your Adobe Commerce integration, follow the [steps to set up PayPal](/payment-methods/paypal/setup-paypal-direct-merchants).

### Amounts in Hungarian Forints (HUF)

In case of a transaction in HUF, PayPal expects the transaction amount and the line item amounts to be rounded to the nearest whole amount. For example, an amount of HUF 74499 must be rounded to HUF 74500. PayPal also expects the rounded line item amounts to add up to the rounded transaction amount.

If you do not round the amounts, Adyen will do that. However, a discrepancy can occur between the transaction amount and the total of the line item amounts. When this happens, PayPal doesn't accept the transaction. To avoid that problem, we recommend that you round all HUF amounts yourself and check that they add 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 Adobe Commerce admin panel and send the payment to the selected terminal.

To set up in-person payments, follow this [checklist](/point-of-sale/get-started/tapi-checklist). To configure in-person payments in your Adobe Commerce store, refer to [Set up In-person payments](/plugins/adobe-commerce/set-up-in-person-payments).

## Admin orders

The plugin offers two types of admin orders:

* [Pay by Link](#pay-by-link)
* [MOTO](#moto)

## 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 Adobe Commerce admin panel.

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](/plugins/adobe-commerce/set-up-the-plugin-in-adobe-commerce#step-2-run-cron).

### Set up Pay by Link

To create payment links, make sure you have the [Pay by Link user permissions](/unified-commerce/pay-by-link/create-payment-links/customer-area#requirements) set up in your Adyen Customer Area. You can also [customize the Pay by Link theme](/unified-commerce/pay-by-link/create-payment-links/customer-area#themes) from your Adyen Customer Area.

To set up Pay by Link in the Adobe Commerce plugin:

1. Under **Admin Orders**, fill out the following fields:

| **Field**                                   | Description                                                                                                |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| **Pay by Link enabled**                     | Set to **Yes** to enable Pay by Link.                                                                      |
| **Pay by Link title**                       | The title that indicates this payment method during checkout.                                              |
| **Default expiration days for Pay by Link** | How many days a payment link should be active. You can override this value when creating the payment link. |

### Create a payment link

After you have [set up Pay by Link](#set-up-pay-by-link), you can start creating payment links for admin orders.

1. In your Adobe Commerce 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.

## MOTO

To use MOTO, you need a MOTO merchant account. Follow [these steps](/online-payments/classic-integrations/hosted-payment-pages/skin/moto-feature#requesting-a-moto-account) to request a merchant account.

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

1. Under **Admin Orders**, fill out the following fields:

| **Field**         | Description                                                                                                                                                                   |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **MOTO enabled**  | Set to **Yes** to enable MOTO.                                                                                                                                                |
| **MOTO accounts** | Enter the name of your MOTO merchant account, Client Key, and the API Key related to your MOTO merchant account. Under **Mode**, select the **Test** or **Live** environment. |

We recommend that you clean your cache.

To test MOTO:

1. In your Adobe Commerce 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**.
4. Choose **Adyen MOTO** from the payment method options.

## Donations

With our Giving feature, you can give your shoppers the option to donate to a nonprofit as part of your payment flow. If the shopper chooses to make a donation, the donation amount is charged to the same payment method they used for the original transaction.

The plugin uses Adyen's [Campaigns overview](/online-payments/donations#donation-campaigns) to accept donations for the campaigns you create and manage in your Customer Area, and supports both [fixed amount and round-up donations post checkout](/online-payments/donations#donation-settings).

Donations are enabled by default, and the donation campaigns that are active in your Adyen Customer Area are automatically fetched and shown to your shoppers at checkout. To disable donations, under **Adyen Giving**, set the **Enabled** field to **No**.

To create and active a donation campaign in your Customer Area, follow the steps in our [documentation](/online-payments/donations#donation-campaigns). After you have set up a campaign, you can [test your integration](/online-payments/donations/testing) to make sure it works as expected.

## Next steps

[Set up stored payment methods](/plugins/adobe-commerce/set-up-tokenization)

[Store your shopper's payment details for later payments.](/plugins/adobe-commerce/set-up-tokenization)

[required](/development-resources/testing/)

[Test your integration](/development-resources/testing/)

[Use our test card numbers to make test payments.](/development-resources/testing/)

[required](/plugins/adobe-commerce/go-live-checklist)

[Configure your live account](/plugins/adobe-commerce/go-live-checklist)

[Follow this checklist before you start accepting live payments.](/plugins/adobe-commerce/go-live-checklist)
