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.
-
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 toProduction.note note 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. -
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
Custom descriptor. -
Click Save.
-
To create a soft descriptor other than the configured default for a website or store view:
- Select the website or store view, in the Scope dropdown menu, for which you want to create a soft descriptor.
- Toggle off Use website (or Use default, dependant on which scope you selected).
- Add your custom text in the text field.
- Click Save.
-
To enable for a website or store view the default soft descriptor or the soft descriptor used for the parent website:
- Select the website or store view, in the Scope dropdown menu, for which you want to enable an existing soft descriptor.
- Toggle on Use website (or Use default, depending on the scope you selected).
- 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
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
AuthorizeorAuthorize and Capture. -
To prioritize a payment method on the checkout page, provide a
Numeric Onlyvalue in the Sort order field. -
To enable 3DS Secure authentication (
Offby default) toggle the 3DS Secure authentication selector toAlwaysorWhen 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.
Configuration options
Numeric Only valueApple 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
AuthorizeorAuthorize 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.
Configuration options
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
AuthorizeorAuthorize and Capture. -
To prioritize a payment method on the checkout page, provide a
Numeric Onlyvalue 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 note 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.
Configuration options
Numeric Only valueButton style
You can also configure the Button style options of the payment buttons:
-
To change the Layout, select
VerticalorHorizontal.note note NOTE If the button style is configured as Horizontaland 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
PillorRectangle. -
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.
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
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.
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.