Settings

Last update: March 12, 2025

CREATED FOR:

Intermediate
Admin
User

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.

On the Admin sidebar, go to Sales > Payment Services.
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.
To enable Payment Services as the payment method for your store, in the General section, toggle Enable Payment Services as payment method to Yes.
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.
Your Payment Services Sandbox ID and Payment Services Production ID values are automatically populated once you setup the Commerce Services Connector and visit the Payment Services dashboard for the first time. Do this to finish the onboarding for your sandbox and/or production environments. These values associate your SaaS ID to Payment Services.

WARNING
If you reset your Payment Services IDs, you must onboard again.
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.
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.

On the Admin sidebar, go to Sales > Payment Services.
Click Settings. See Introduction to Payment Services Home for more information.
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.
Add your custom text (up to 22 characters) in the text field, replacing Soft descriptor.
Click Save.
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.
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: Off / On

Payment mode

store view

Set the method, or environment, for your store. Options: Sandbox / Production

Payment Services Sandbox ID

store view

Your sandbox merchant ID, which is auto-generated during sandbox onboarding.

Payment Services Production ID

store view

Your production merchant ID, which is auto-generated during production (live) 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.

On the Admin sidebar, go to Sales > Payment Services.
Click Settings. See Introduction to Payment Services Home for more information.
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.

On the Admin sidebar, go to Sales > Payment Services.
Select the store view, in the Scope dropdown menu, for which you want to enable a payment method.
In the Credit card fields section, edit the value in the Checkout title field to change the name of the payment method displayed during checkout.
To set the payment action, toggle Payment action to Authorize or Authorize and Capture.
To prioritize a payment method on the checkout page, provide a Numeric Only value in the Sort order field.
To enable 3DS Secure authentication (Off by default) toggle the 3DS Secure authentication selector to Always or When required.
To enable or disable credit card fields on the checkout page, toggle the Show on checkout page selector.
To enable or disable card vaulting, toggle the Vault enabled selector.
To enable or disable vaulted payment methods in the Admin (for merchants to complete orders for customers in the Admin using their vaulted payment method), toggle the Show vaulted methods in Admin selector.
To enable or disable debug mode, toggle the Debug Mode selector.
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.
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

Sort order

store view

The sorting order for the specified payment method on the checkout page. Numeric Only value

3DS Secure authentication

website

Enable or disable 3DS Secure authentication. Options: Always / When Required / Off

Show on checkout page

website

Enable or disable credit card fields to show on checkout page. Options: Off / On

Vault enabled

store view

Enable or disable credit card vaulting. Options: Off / On

Show vaulted payment methods in Admin

store view

Enable or disable ability for merchant to complete orders for customers in the Admin using a vaulted payment method. Options: Off / On

Debug Mode

website

Enable or disable Debug Mode. Options: Off / On

Apple Pay

The Apple Pay button payment option allows you to provide an Apple Pay payment button in your store’s checkout from the Safari browser (for up to 99 domains per merchant account).

You can only use Apple Pay if you complete Apple Pay self-registration via Paypal and then configure Apple Pay for your stores. See Payments options for more information.

You can enable and configure the Apple Pay button payment option:

On the Admin sidebar, go to Sales > Payment Services.
Select the store view, in the Scope dropdown menu, for which you want to enable a payment method.
In the Apple Pay section, edit the value in the Checkout title field to change the name of the payment method displayed during checkout.
To set the payment action, toggle Payment action to Authorize or Authorize and Capture.
To enable or disable Apple Pay on the checkout page, toggle the Show Apple Pay on checkout page selector.
To enable or disable Apple Pay on the product detail page, toggle the Show Apple Pay on product detail page selector.
To enable or disable Apple Pay on the mini cart preview, toggle the Show Apple Pay on the mini cart preview selector.
To enable or disable Apple Pay on the cart page, toggle the Show Apple Pay on cart page selector.
To enable or disable debug mode, toggle the Debug Mode selector.
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.
Flush the cache.

Configuration options

Field

Scope

Description

Checkout 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 the Apple Pay button to show on checkout page. Options: Off / On

Show on checkout page

website

Enable or disable the Apple Pay button to show on product detail page. Options: Off / On

Show on mini cart preview

website

Enable or disable the Apple Pay button to show on mini cart preview. Options: Off / On

Show on cart page

website

Enable or disable the Apple Pay button to show on cart page. Options: Off / On

Debug Mode

website

Enable or disable Debug Mode. Options: Off / On

Payment buttons

The PayPal payment 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 payment buttons payment options:

Select the store view, in the Scope dropdown menu, for which you want to enable a payment method.
To change the name of the payment method as shown during checkout, edit the value in the Checkout Title field.
To set the payment action, toggle Payment action to Authorize or Authorize and Capture.
To prioritize a payment method on the checkout page, provide a Numeric Only value in the Sort order field.
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
- Show PayPal Credit and Debit Card button
  
  NOTE
  To use Apple Pay you must have an Apple sandbox tester 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, complete self-registration with Apple Pay (Register your live domain section only) and configure it for your stores in Payment Services.
  
  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.
To enable debug mode, toggle the Debug Mode selector.
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.
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

Sort order

store view

The sorting order for the specified payment method on the checkout page. Numeric Only value

Show PayPal buttons on checkout page

store view

Enable or disable PayPal payment buttons on the checkout page. Options: Yes / No

Show PayPal buttons on product detail page

store view

Enable or disable PayPal payment buttons on the product detail page. Options: Yes / No

Show PayPal buttons in mini-cart preview

store view

Enable or disable PayPal payment buttons in the mini-cart preview. Options: Off / On

Show PayPal buttons on cart page

store view

Enable or disable PayPal payment buttons on the cart page. Options: Off / On

Show PayPal Pay Later button

store view

Enable or disable pay later payment option appearance where payment buttons are displayed. Options: Off / On

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: Off / On

Show Venmo button

store view

Enable or disable the Venmo payment option where payment buttons are displayed. Options: Off / On

Show Apple Pay button

store view

Enable or disable the Apple Pay payment option where payment buttons are displayed. Options: Off / On

Show PayPal Credit and Debit card button

store view

Enable or disable the Credit and Debit card payment option where payment buttons are displayed. Options: Off / On

Debug Mode

website

Enable or disable Debug Mode. Options: Off / On

Button style

You can also configure the Button style options of the payment buttons:

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 payment buttons, you may only see two buttons displayed on the product page, checkout page, and mini-cart, and one button displayed in the cart.
To enable the tagline in a horizontal layout, toggle the Show tagline selector.
To modify the Color, select the desired color option.
To modify the Shape, select Pill or Rectangle.
To enable button height selector, toggle the Responsive button height selector.
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. In the image below, the Shape is set to Rectangle and the Label is set to PayPal (recommended).
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.
Flush the cache.

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

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: Off / On

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: Off / On

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

Configure roles

To ensure that Admin users can create and manage orders in the Commerce Admin, enable Payment Services-specific resources to user roles.

See User roles to learn how to manage roles.

When assigning resources to the role, you must select:

Pay with Payment Services—This resource ensures that when you create an order in the Admin, Payment Services credit cards are available as a payment method. If you select the Actions parent resource, this resource will also be selected.
Payment Services—This resource includes the Dashboard and SaaS Services Proxy resources, which must also be selected. They ensure that Payment Services appears in the Sales menu.

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.

On the Admin sidebar, go to System > Cache Management.
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.

You can also use card vaulting in the Admin to complete subsequent orders for existing customers.

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

See Credit card vaulting for more information.

3DS

3DS protects customers and merchants from fraudulent activity in their stores, and enables compliance with European Union (EU) standards.

Enable or disable 3DS in the Credit card field settings.

See 3DS in Security for more information.

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.

See Command-line configuration for more information on configuring scopes for multiple PayPal accounts via CLI.

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.

recommendation-more-help