DocumentationCommercePayment Services Guide

Legacy Payment Services Configuration

Last update: Mon Jan 29 2024 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 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.

    img-md
    w-400 modal-image
    Methods view

  3. Expand the Recommended Solutions section.

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

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

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

    note warning
    WARNING
    Your Sandbox Merchant ID and Production Merchant ID are auto-generated and present in their respectable fields when you have finished onboarding for the sandbox and/or production. Do not remove or change these IDs.

  7. 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 Custom descriptor or the existing value.

  8. Click Save Config to save your changes.

  9. 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
Sandbox Merchant ID
store view
Your sandbox merchant ID, which is auto-generated during sandbox onboarding. Do not change or alter this ID.
Production Merchant ID
store view
Your production merchant ID, which is auto-generated during sandbox onboarding. Do not change or alter this 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 Recommended Solutions 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 3DS 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
3DS 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.

  1. On the Admin sidebar, go to Stores > Settings > Configuration.
  2. In the left panel, expand Sales and choose Payment Methods.
  3. Expand the Recommended Solutions 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. To show Apple Pay on the checkout page, select Yes for the Show buttons on checkout page.
  8. To show Apple Pay on the product detail page, select Yes for the Show buttons on product detail page.
  9. To show Apple Pay in the mini cart preview, select Yes for Show buttons in mini cart preview.
  10. To show Apple Pay on the cart page, select Yes for the Show buttons on cart page.
  11. To enable debug mode, select Yes for the Debug Mode (No disables it).
  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
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
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

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 Recommended Solutions 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.
  9. To show PayPal payment buttons on the checkout page, select Yes for the Show buttons on checkout page.
  10. To show PayPal payment buttons on the product detail page, select Yes for the Show buttons on product detail page.
  11. To show PayPal payment buttons in the mini cart preview, select Yes for Show buttons in mini cart preview.
  12. To show PayPal payment buttons on the cart page, select Yes for the Show buttons on cart page.
  13. To enable Venmo as a payment option, select Yes for Venmo Enabled.
  14. To enable credit and debit cards as a payment option (PayPal Smart button), select Yes for Credit and Debit Card Enabled.
  15. To enable/disable the PayPal Pay Later payment option, select Yes/No for PayPal Pay Later Enabled.
  16. To enable debug mode, select Yes for the Debug Mode (No disables it).
  17. To save your changes, click Save Config .
  18. 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:

  1. On the Admin sidebar, go to Stores > Settings > Configuration.
  2. In the left panel, expand Sales and choose Payment Methods.
  3. Expand the Recommended Solutions 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.

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

Flush the cache

If you change the configuration, manually flush the cache so that your store shows the latest configuration settings.

recommendation-more-help
87189544-c8b9-4aef-af07-ed3578763c38