Legacy Payment Services Configuration
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.
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Sales and choose Payment Methods.
-
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.
-
Expand the FEATURED ADOBE PAYMENT SOLUTION section to access the Payment Services section.
-
In the Payment Services section, expand the General Configuration section.
-
For Enable, set it to
Yesto enable Payment Services for your store. -
For Method, set it to
Sandboxif you are still testing Payment Services for your store orProductionif you are ready to enable live payments. -
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.
WARNINGIf 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 or Production IDs. If you reset your Payment Services IDs, you must onboard again. -
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.
-
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 descriptoror the existing value. -
Click Save Config to save your changes.
-
Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.
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.
- On the Admin sidebar, go to Stores > Settings > Configuration.
- In the left panel, expand Sales and choose Payment Methods.
- Expand the FEATURED ADOBE PAYMENT SOLUTION section.
- In the Payment Services section, expand the Credit Card Fields section.
- For Title, enter text (if needed) to change the name of the payment method as shown during checkout.
- To set the payment action, select Authorize or Authorize and Capture.
- To prioritize a payment method on the checkout page, provide a
Numeric Onlyvalue in the Sort order field. - For Show on checkout page, choose
Yesto enable credit card fields on the checkout page. - For Vault Enabled, choose
Yesto enable credit card vaulting for checkout. - For Vault Enabled in Admin, choose
Yesto enable the merchant to create orders for customers using their vaulted credit card. - To enable 3D Secure authentication (
Offby default) chooseAlwaysorWhen required. - For Debug Mode, choose
Yesto enable debug mode, orNoto disable it. - Click Save Config to save your changes.
- 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 |
Apple Pay
The Apple Pay payment option allows the merchant to offer Apple Pay to their shoppers, who can use Touch ID on their devices to make purchases from the Safari browser. Merchants can add up to 99 domains per merchant account.
See Payments options for more information.
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Sales and choose Payment Methods.
-
Expand the FEATURED ADOBE PAYMENT SOLUTION section.
-
In the Payment Services section, expand the Apple Pay section.
-
For Title, enter text (if needed) to change the name of the payment method as shown during checkout.
-
To set the payment action, select Authorize or Authorize and Capture.
-
Specify where the Apple Pay option is enabled in Adobe Commerce by selecting
Yesin 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
-
To enable debug mode, select
Yesfor the Debug Mode (Nodisables it). -
To save your changes, click Save Config .
-
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.
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Sales and choose Payment Methods.
-
Expand the FEATURED ADOBE PAYMENT SOLUTION section.
-
In the Payment Services section, expand the Google Pay section.
-
(Optional) Change the name of the payment method shown during checkout by entering the new name in the Title field.
-
Set the payment action by selecting Authorize or Authorize and Capture.
-
Specify where the Google Pay option is enabled in Adobe Commerce by selecting
Yesin 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
-
To enable 3D Secure authentication (
Offby default) chooseAlwaysorWhen required. -
To enable debug mode, select
Yesfor the Debug Mode (Nodisables it). -
Configure the appearance of the Google Pay button by selecting the Button Color, Button Type, and Button Style as needed.
-
To set the height, uses the default value for height defined in Button Style.
-
To save your changes, click Save Config .
-
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:
-
On the Admin sidebar, go to Stores > Settings > Configuration.
-
In the left panel, expand Sales and choose Payment Methods.
-
Expand the FEATURED ADOBE PAYMENT SOLUTION section.
-
In the Payment Services section, expand the PayPal payment buttons section.
-
To change the name of the payment method as shown during checkout, edit the Title field.
-
To set the payment action, select Authorize or Authorize and Capture.
-
To prioritize a payment method on the checkout page, provide a
Numeric Onlyvalue in the Sort order field. -
To enable/disable the Pay Later messaging, select
Yes/Nofor Display Pay Later Message. -
Specify where the PayPal payment buttons are enabled in Adobe Commerce by selecting
Yesin 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
-
To enable Venmo as a payment option, select
Yesfor Venmo Enabled. -
To enable credit and debit cards as a payment option (PayPal Smart button), select
Yesfor Credit and Debit Card Enabled. -
To enable/disable the PayPal Pay Later payment option, select
Yes/Nofor PayPal Pay Later Enabled. -
To enable debug mode, select
Yesfor the Debug Mode (Nodisables it). -
To save your changes, click Save Config .
-
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 Pay Later messaging in the shopping cart, product page, mini-cart, and during the checkout flow. Options: Yes / No |
| 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:
- On the Admin sidebar, go to Stores > Settings > Configuration.
- In the left panel, expand Sales and choose Payment Methods.
- Expand the FEATURED ADOBE PAYMENT SOLUTION section.
- In the Payment Services section, expand the PayPal Smart Button Styling section.
- To set the layout, select
VerticalorHorizontalfor Layout - To set the color, select from the available colors in Color.
- To set the shape, select
RectangularorPillfor Shape. - To use the default height, select
YesorNofor Use Default Height. - To set the custom height, add desired pixel height for Height.
- To set the tagline, select
YesorNofor Tagline. - To save your changes, click Save Config .
- Navigate to System > Cache Management, and then click Flush Cache to refresh all invalid caches.
You can also configure payment button styling in Settings from Payment Services Home.
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 |