Settings

You can customize Payment Services to your needs with helpful settings in the Payment Services Home.

To configure Payment Services for Adobe Commerce and Magento Open Source click Settings. These configuration options apply only to the environment that is set in the Payment mode field of the General configuration options.

For multi-store or legacy configuration see Configure in the Admin.

Configure General settings

The General settings provide the ability to enable or disable Payment Services as your payment method and add information to customer transactions to mark or prefix a website or store view with custom information.

Enable Payment Services

You can enable Payment Services for your website, and enable either sandbox testing or live payments.

  1. On the Admin sidebar, go to Sales > Payment Services.

    Home view

  2. Click Settings. See Introduction to Payment Services Home for more information.

    The General section includes settings used to enable Payment Services as the payment method.

  3. To enable Payment Services as the payment method for your store, in the General section, toggle Enable Payment Services as payment method to Yes.

  4. If you are still testing Payment Services for your store, set Payment mode to Sandbox. If you are ready to enable live payments, set it to Production.

    NOTE

    Your Sandbox Merchant ID and Production Merchant ID are auto-generated and present in their respectable fields when you finish onboarding for the sandbox and/or production.

  5. Click Save.

    If you try to navigate away from this view without saving your changes, a modal appears that prompts you to discard changes, keep editing, or save changes.

  6. Navigate to System > Cache Management and click Flush Cache to refresh all invalid caches.

You can now proceed to changing the default settings for payment options functions and storefront display.

Add soft descriptor

You can add a Soft Descriptor to your website(s) or individual store view(s) configuration. Soft descriptors show on customer transaction bank statements. If you have multiple stores/brands/catalogs, for instance, you can easily delineate between those by adding custom text to the Soft Descriptor field.

  1. On the Admin sidebar, go to Sales > Payment Services.

    Home view

  2. Click Settings. See Introduction to Payment Services Home for more information.

  3. Select the website or store view, in the Scope dropdown menu, for which you want to create a soft descriptor. For initial setup, leave this as Default to set the default value.

  4. Add your custom text (up to 22 characters) in the text field, replacing Custom descriptor.

  5. Click Save.

  6. To create a soft descriptor other than the configured default for a website or store view:

    1. Select the website or store view, in the Scope dropdown menu, for which you want to create a soft descriptor.
    2. Toggle off Use website (or Use default, dependant on which scope you selected).
    3. Add your custom text in the text field.
    4. Click Save.
  7. To enable for a website or store view the default soft descriptor or the soft descriptor used for the parent website:

    1. Select the website or store view, in the Scope dropdown menu, for which you want to enable an existing soft descriptor.
    2. Toggle on Use website (or Use default, depending on the scope you selected).
    3. Click Save.

    If you try to navigate away from this view without saving your changes, a modal appears that prompts you to discard changes, keep editing, or save changes.

Configuration options

Field Scope Description
Enable website Enable or disable Payment Services for your website. Options: Yes / No
Payment mode store view Set the method, or environment, for your store. Options: Sandbox / Production
Sandbox Merchant ID store view Your sandbox merchant ID, which is auto-generated during sandbox onboarding.
Production Merchant ID store view Your production merchant ID, which is auto-generated during sandbox onboarding.
Soft Descriptor website or store view Add a soft descriptor to your website(s) and store view(s) to add information to customer transactions which delineate brands, stores, or product lines. The Use website toggle applies any soft descriptor added at the website level. The Use default toggle applies any soft descriptor added as the default.

Configure payment options

Now that you have enabled Payment Services for your website, you can change the default settings for payment functions and storefront display.

  1. On the Admin sidebar, go to Sales > Payment Services.

    Home view

  2. Click Settings. See Introduction to Payment Services Home for more information.

  3. Configure payment options for credit cards, payment buttons, and button style, per the following sections.

Credit card fields

The Credit Card Fields settings provide a simple and secure checkout option for credit card or debit card payment methods.

See Payments options for more information.

  1. On the Admin sidebar, go to Sales > Payment Services.

    Home view

  2. Select the store view, in the Scope dropdown menu, for which you want to enable a payment method.

  3. To change the name of the payment method displayed during checkout, edit the value in the Checkout title field.

  4. To set the payment action, toggle Payment action to Authorize or Authorize and Capture.

  5. To enable or disable credit card fields on the checkout page, toggle the Show on checkout page selector.

  6. To enable or disable card vaulting, toggle the Vault enabled selector.

  7. To enable or disable debug mode, toggle the Debug Mode selector.

  8. Click Save.

    If you try to navigate away from this view without saving your changes, a modal appears that prompts you to discard changes, keep editing, or save changes.

  9. Flush the cache.

Configuration options

Field Scope Description
Title store view Add the text for display as the title for this payment option in the Payment Method view during checkout. Options: text field
Payment Action website The payment action for the specified payment method. Options: Authorize / Authorize and Capture
Show on checkout page website Enable or disable credit card fields to show on checkout page. Options: Yes / No
Vault enabled website Enable or disable credit card vaulting. Options: Yes / No
Debug Mode website Enable or disable Debug Mode. Options: Yes / No

Payment buttons

The PayPal Smart Buttons payment options provide a simple, fast, and secure checkout process for your customer. See Payments options for more information.

You can enable and configure the PayPal smart buttons payment options:

  1. Select the store view, in the Scope dropdown menu, for which you want to enable a payment method.

  2. To change the name of the payment method as shown during checkout, edit the value in the Checkout Title field.

  3. To set the payment action, toggle Payment action to Authorize or Authorize and Capture.

  4. Use the toggle selectors to enable or disable PayPal smart button display features:

    • Show PayPal buttons on product checkout page

    • Show PayPal buttons on product detail page

    • Show PayPal buttons in mini-cart preview

    • Show PayPal buttons on cart page

    • Show PayPal Pay Later button

    • Show PayPal Pay Later message

    • Show Venmo button

    • Show Apple Pay button

      NOTE

      To use Apple Pay you must have an Apple Developer Account (complete with fake credit card and billing information) to test it. When you are ready to use Apple Pay in sandbox or production mode, after completing any testing and validation, contact your Sales representative to enable it for your live store(s).

      As you toggle on/off visibility to payment buttons or the PayPal Pay Later message, a visual preview of that configuration shows at the bottom of the Settings page.

  5. To enable debug mode, toggle the Debug Mode selector.

  6. Click Save.

    If you try to navigate away from this view without saving your changes, a modal appears that prompts you to discard changes, keep editing, or save changes.

  7. Flush the cache.

Configuration options

Field Scope Description
Title store view Add the text to be displayed as the title for this payment option in the Payment Method view during checkout. Options: text field
Payment Action website The payment action for the specified payment method. Options: Authorize / Authorize and Capture
Show PayPal buttons on checkout page store view Enable or disable PayPal Smart Buttons on the checkout page. Options: Yes / No
Show PayPal buttons on product detail page store view Enable or disable PayPal Smart Buttons on the product detail page. Options: Yes / No
Show PayPal buttons in mini-cart preview store view Enable or disable PayPal Smart Buttons in the mini-cart preview. Options: Yes / No
Show PayPal buttons on cart page store view Enable or disable PayPal Smart Buttons on the cart page. Options: Yes / No
Show PayPal Pay Later button store view Enable or disable pay later payment option appearance where payment buttons are displayed. Options: Yes / No
Show PayPal Pay Later Message website Enable or disable the Pay Later messaging in the shopping cart, product page, mini-cart, and during the checkout flow. Options: Yes / No
Show Venmo button store view Enable or disable the Venmo payment option where payment buttons are displayed. Options: Yes / No
Show Apple Pay button store view Enable or disable the Apple Pay payment option where payment buttons are displayed. Options: Yes / No
Debug Mode website Enable or disable Debug Mode. Options: Yes / No

Button style

You can also configure the Button style options of the PayPal smart buttons:

  1. To change the Layout, select Vertical or Horizontal.

    NOTE

    If the button style is configured as Horizontal and your store is configured to show multiple PayPal smart buttons, you may only see two buttons displayed on the product page, checkout page, and mini-cart, and one button displayed in the cart.

  2. To enable the tagline in a horizontal layout, toggle the Show tagline selector.

  3. To modify the Color, select the desired color option.

  4. To modify the Shape, select Pill or Rectangle.

  5. To enable button height selector, toggle the Responsive button height selector.

  6. To modify the Label, select the desired label option.

    As you change configuration options for layout, color, shape, height, and label, a visual preview of that configuration shows at the bottom of the Settings page.

  7. Click Save.

    If you try to navigate away from this view without saving your changes, a modal appears that prompts you to discard changes, keep editing, or save changes.

  8. Flush the cache.

You can configure PayPal Smart Buttons styling in the Legacy configuration in the Admin or here in Payment Services Home. See PayPal’s Buttons style guide for more information about the options.

Configuration options

Field Scope Description
Layout Store View Define style of layout for payment buttons. Options: Vertical / Horizontal
Tagline Store View Enable/disable tagline. Options: Yes / No
Color Store View Define color of the payment buttons. Options: Blue / Gold / Silver / White / Black
Shape Store View Define shape of the payment buttons. Options: Rectangular / Pill
Responsive Button Height Store View Defines if payment buttons use a default height. Options: Yes / No
Height Store View Define height of the payment buttons. Default value: none
Label Store View Define label that appears in the payment buttons. Options: PayPal / Checkout / Buynow / Pay / Installment

Flush the cache

If you change the configuration in Settings, for example toggling the Apple Pay, Venmo, or PayPal PayLater buttons, manually flush the cache so that your store shows the latest configurations.

  1. On the Admin sidebar, go to System > Cache Management.
  2. Click Flush Cache to refresh all invalid caches.

If any Cache Type in the Cache Management table has an INVALIDATED status, your store might not show the most recent configuration for that item. Flush the cache to update your store to show the latest configuration.

To ensure that your store is showing the correct configuration, periodically flush the cache.

Card vaulting

You can enable functionality that allows your customers to vault—or “save”—their credit card information in their My Account to use for future purchases.

Enable or disable card vaulting in the Credit card field settings.

See Credit card vaulting for more information about vaulting.

Use multiple PayPal accounts

In Payment Services, you can use multiple PayPal accounts within one merchant account on the website level. For instance, if you are operating your store(s) in multiple countries (which use different currencies) or want to use Adobe Commerce for some parts of your business but not all, you can set up your merchant account to use multiple PayPal accounts.

See Site, Store, and View Scope for more information about the hierarchy of websites, stores, and store views.

Your Sales representative can create a new scope for your merchant account and onboard the additional site with PayPal so that any of the PayPal buttons you configure to appear will show on your site. Contact your Sales representative for assistance with using multiple PayPal accounts for your websites.

On this page