DocumentationCommercePayment Services Guide

Payment Services Configuration

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Intermediate
  • Admin
  • User

You can customize Payment Services to your needs with helpful configuration options in the Admin.

When you configure Payment Services for Adobe Commerce and Magento Open Source in the Admin, those configurations apply only to the environment that is set in the Method field of General Configuration. Any changes you make in the configuration fields are independent of switching the Method selection—if you switch the method, your selections do not reset.

General configuration

You can enable Payment Services for your store and your Merchant Location, and enable either sandbox testing or live payments in the General Configuration section.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Payment Methods.

  3. Set the Merchant Country field in the Merchant Location. If a Merchant Country is not specified, the Default Country from the general configuration is used.

  4. Expand the FEATURED ADOBE PAYMENT SOLUTION section to access the Payment Services section.

  5. In the Payment Services section, expand the General Configuration section.

  6. For Enable, set it to Yes to enable Payment Services for your store.

  7. For Method, set it to Sandbox if you are still testing Payment Services for your store or Production if you are ready to enable live payments.

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

    note warning
    WARNING
    If you need to change your dataspace ID in the Commerce Services Connector, you need to reset your Payment Services ID. Click Reset Payment Services ID to reset your Sandbox ID. If you reset your Payment Services Sandbox ID, you must onboard again.

  9. Your PayPal Merchant ID and PayPal Merchant Status values are automatically provided by PayPal once you visit the Payment Services dashboard for the first time.

  10. For Soft Descriptor (custom values which show on customer transaction bank statements to delineate between stores/brands/catalogs), add your custom text (up to 22 characters) in the text field, replacing Soft descriptor or the existing value.

  11. Click Save Config to save your changes.

  12. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Featured Adobe Solution view {width="700" modal="regular"}

Configuration options

Field
Scope
Description
Enable
website
Enable or disable Payment Services for your website. Options: Yes / No
Method
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.
PayPal Merchant ID
store view
Your unique PayPal Merchant account ID, generated when you create your PayPal account.
PayPal Merchant Status
store view
Status of your PayPal Merchant ID.
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.

Credit Card Fields

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

See Payments options for more information.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.
  2. In the left panel, expand Sales and choose Payment Methods.
  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.
  4. In the Payment Services section, expand the Credit Card Fields section.
  5. For Title, enter text (if needed) to change the name of the payment method as shown during checkout.
  6. To set the payment action, select Authorize or Authorize and Capture.
  7. To prioritize a payment method on the checkout page, provide a Numeric Only value in the Sort order field.
  8. For Show on checkout page, choose Yes to enable credit card fields on the checkout page.
  9. For Vault Enabled, choose Yes to enable credit card vaulting for checkout.
  10. For Vault Enabled in Admin, choose Yes to enable the merchant to create orders for customers using their vaulted credit card.
  11. To enable 3D Secure authentication (Off by default) choose Always or When required.
  12. For Debug Mode, choose Yes to enable debug mode, or No to disable it.
  13. Click Save Config to save your changes.
  14. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Configuration options

Field
Scope
Description
Title
store view
Add the text to 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
Show on checkout page
website
Enable or disable credit card fields on the checkout page. Options: Yes / No
Vault enabled
store view
Enable or disable credit card vaulting. Options: Yes / No
Vault enabled in Admin
store view
Enable or disable ability for merchant to complete orders for customers in the Admin using a vaulted payment method. Options: Yes / No
3D Secure authentication
website
Enable or disable 3DS Secure authentication. Options: Always / When Required / Off
Debug Mode
website
Enable or disable Debug Mode. Options: Yes / No

Fastlane

Fastlane by PayPal is a fast and easy way to pay securely online. During a Guest checkout, you can securely store your card and shipping details for even faster purchases in the future.

See Payment options for more information.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Payment Methods.

  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.

  4. In the Payment Services section, expand the Fastlane section.

  5. To enable it, select Yes for the Enable Fastlane (No disables it).

    note note
    NOTE
    If Fastlane is enabled, the Credit Card Fields payment option is disabled.

  6. For Title, enter text (if needed) to change the name of the payment method as shown during checkout. The default title is Credit Card (via Fastlane)

  7. To set the payment action, select Authorize or Authorize and Capture.

  8. To prioritize a payment method on the checkout page, provide a Numeric Only value in the Sort order field.

  9. Specify whether the Fastlane branding is enabled during checkout in Adobe Commerce by setting the Enable messaging field to Yes.

  10. Click Save Config to save your changes.

  11. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Field
Scope
Description
Enable Fastlane
store view
Enable or disable Fastlane on the checkout page. Options: Yes / No
Title
store view
Add the text to display as the title for this payment option in the Payment Method view during checkout. The default value is Credit Card (via Fastlane). Options: text field
Payment Action
website
The payment action for the specified payment method. Options: Authorize / Authorize and Capture
Sort order
store view
The sort order for the specified payment method on the checkout page. Numeric Only value
Enable messaging
store view
Specify whether the Fastlane branding is enabled during checkout in Adobe Commerce. Options: Yes / No

Optional. Advanced Style Settings

These optional settings can customize how Fastlane displays on your website.

TIP
Styles that do not meet accessibility guidelines revert to the default settings.
  1. In the Payment Services section, navigate to the Fastlane section.
  2. Expand the Advanced Style Settings (optional) section.
  3. Modify settings as needed.
  4. Click Save Config to save your changes.

See PayPal Developer Docs for more information on customization.

Root Settings

These optional settings modify the overall Fastlane checkout component.

Field
Scope
Description
Background Color
store view
Defines the background color of the component. Only RGB values
Border Color
store view
Defines the border color of the component. Only RGB values
Font Family
store view
Sets the font of the component. Only fonts available in your theme are displayed
Font Size Base
store view
Defines the size of the font. Only px (pixel) values
Padding
store view
Sets the padding in the component. Only px (pixel) values
Primary Color
store view
Defines the main color of the component. Only RGB values
Text Color
store view
Defines the main color of the text in the component. Only RGB values

Input Settings

These optional settings apply to the customer input fields of your Fastlane component.

Field
Scope
Description
Background Color
store view
Defines the background color of the component. Only RGB values
Border Color
store view
Defines the border color of the component. Only RGB values
Border Radius
store view
Defines the radius of the border. Only px (pixel) values
Border Width
store view
Defines the width of the border. Only px (pixel) values
Focus Border Color
store view
Defines the focus border color of the component. Only RGB values
Text Color Base
store view
Defines the main color of the text in the component. Only RGB values

Apple Pay

With Apple Pay, merchants can offer a secure, fast, and seamless checkout experience in Safari—supporting up to 99 domains per merchant account. The Apple Pay button automatically populates payment, contact, and shipping information from the customer’s iOS or macOS device, enabling quick, one-tap purchases that can help boost conversion rates.

See Payments options for more information.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Payment Methods.

  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.

  4. In the Payment Services section, expand the Apple Pay section.

  5. For Title, enter text (if needed) to change the name of the payment method as shown during checkout.

  6. To set the payment action, select Authorize or Authorize and Capture.

  7. Specify where the Apple Pay option is enabled in Adobe Commerce by selecting Yes in the following options as needed:

    • Show Apple Pay on checkout page
    • Show Apple Pay on product detail page
    • Show Apple Pay in mini cart preview
    • Show Apple Pay on cart page

  8. To enable debug mode, select Yes for the Debug Mode (No disables it).

  9. To save your changes, click Save Config .

  10. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Configuration options

Field
Scope
Description
Title
store view
Add the text to 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 Apple Pay on the checkout page. Options: Yes / No
Sort order
store view
The sort order for the specified payment method on the checkout page. Numeric Only value
Show buttons on product detail page
store view
Enable or disable Apple Pay on the product detail page. Options: Yes / No
Show buttons in mini-cart preview
store view
Enable or disable Apple Pay in the mini-cart preview. Options: Yes / No
Show buttons on cart page
store view
Enable or disable Apple Pay in on the cart page. Options: Yes / No
Debug Mode
website
Enable or disable Debug Mode. Options: Yes / No

Google Pay

The Google Pay payment option allows the merchant to offer Google Pay to their shoppers, who can use the Google Wallet on their devices to make purchases.

See Payments options for more information.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Payment Methods.

  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.

  4. In the Payment Services section, expand the Google Pay section.

  5. (Optional) Change the name of the payment method shown during checkout by entering the new name in the Title field.

  6. Set the payment action by selecting Authorize or Authorize and Capture.

  7. Specify where the Google Pay option is enabled in Adobe Commerce by selecting Yes in the following options as needed:

    • Show Google Pay on checkout page
    • Show Google Pay on product detail page
    • Show Google Pay in mini cart preview
    • Show Google Pay on cart page

  8. To enable 3D Secure authentication (Off by default) choose Always or When required.

  9. To enable debug mode, select Yes for the Debug Mode (No disables it).

  10. Configure the appearance of the Google Pay button by selecting the Button Color, Button Type, and Button Style as needed.

  11. To set the height, uses the default value for height defined in Button Style.

  12. To save your changes, click Save Config .

  13. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Configuration options

Field
Scope
Description
Title
store view
Specifies the text label that displays 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 Google Pay on the checkout page. Options: Yes / No
Sort order
store view
The sort order for the specified payment method on the checkout page. Numeric Only value
Show buttons on product detail page
store view
Enable or disable Google Pay on the product detail page. Options: Yes / No
Show buttons in mini-cart preview
store view
Enable or disable Google Pay in the mini-cart preview. Options: Yes / No
Show buttons on cart page
store view
Enable or disable Google Pay on the cart page. Options: Yes / No
3D Secure authentication
store view
Enable or disable 3D Secure authentication. Options: Always / When Required / Off
Debug Mode
website
Enable or disable Debug Mode. Options: Yes / No
Button Color
Store View
Define color of the Google Pay button. Options: Default / Black / White
Button Type
Store View
Define type of the Google Pay button. Options: buy / checkout / order / pay / plain

See Google Pay API request object options documentation for more information.

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

Configure PayPal payment buttons

You can enable and configure the PayPal payment buttons payment options within the Admin:

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Sales and choose Payment Methods.

  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.

  4. In the Payment Services section, expand the PayPal payment buttons section.

  5. To change the name of the payment method as shown during checkout, edit the Title field.

  6. To set the payment action, select Authorize or Authorize and Capture.

  7. To prioritize a payment method on the checkout page, provide a Numeric Only value in the Sort order field.

  8. To enable/disable the Pay Later messaging, select Yes/No for Display Pay Later Message.

    • If you enable the Pay Later messaging, a Configure Messaging modal button is displayed so you can set the styles for the PayPal Pay Later messaging.

  9. Specify where the PayPal payment buttons are enabled in Adobe Commerce by selecting Yes in the following options as needed:

    • Show buttons on checkout page
    • Show buttons on product detail page
    • Show buttons in mini cart preview
    • Show buttons on cart page

  10. To enable Venmo as a payment option, select Yes for Venmo Enabled.

  11. To enable credit and debit cards as a payment option (PayPal Smart button), select Yes for Credit and Debit Card Enabled.

  12. To enable/disable the PayPal Pay Later payment option, select Yes/No for PayPal Pay Later Enabled.

  13. To enable debug mode, select Yes for the Debug Mode (No disables it).

  14. To save your changes, click Save Config .

  15. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

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
Display Pay Later Message
website
Enable or disable the PayPal Pay Later messaging in the shopping cart, product page, mini-cart, and during the checkout flow. Options: Yes / No
Configure Messaging
store view
Modify the PayPal Pay Later Messaging styles. Options: Product page / Cart
Show buttons on checkout page
store view
Enable or disable PayPal payment buttons on the checkout page. Options: Yes / No
Show buttons on product detail page
store view
Enable or disable PayPal payment buttons on the product detail page. Options: Yes / No
Show buttons in mini-cart preview
store view
Enable or disable PayPal payment buttons in the mini-cart preview. Options: Yes / No
Show buttons on cart page
store view
Enable or disable PayPal payment buttons in on the cart page. Options: Yes / No
Venmo Enabled
store view
Enable or disable the Venmo payment option where payment buttons are displayed. Options: Yes / No
Credit and Debit Card Enabled
store view
Enable or disable the Credit and Debit card options where payment buttons are displayed. Options: Yes / No
PayPal Pay Later Enabled
store view
Enable or disable PayPal Pay Later payment option appearance 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 payment buttons:

  1. On the Admin sidebar, go to Stores > Settings > Configuration.
  2. In the left panel, expand Sales and choose Payment Methods.
  3. Expand the FEATURED ADOBE PAYMENT SOLUTION section.
  4. In the Payment Services section, expand the PayPal Smart Button Styling section.
  5. To set the layout, select Vertical or Horizontal for Layout
  6. To set the color, select from the available colors in Color.
  7. To set the shape, select Rectangular or Pill for Shape.
  8. To use the default height, select Yes or No for Use Default Height.
  9. To set the custom height, add desired pixel height for Height.
  10. To set the tagline, select Yes or No for Tagline.
  11. To save your changes, click Save Config .
  12. Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.

Configuration options

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

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.

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
00b8a45a-5862-4817-8e1e-074170ebb953