Legacy Payment Services Configuration

Last update: 2023-09-06
  • 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.

    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.

    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

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 Smart Buttons

The PayPal Smart Buttons payment options provide a simple, fast, and secure checkout process for your customer.

See Payments options for more information.

Configure PayPal Smart Buttons

You can enable and configure the PayPal Smart 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 Smart 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 Smart Buttons on the checkout page, select Yes for the Show buttons on checkout page.
  10. To show PayPal Smart Buttons on the product detail page, select Yes for the Show buttons on product detail page.
  11. To show PayPal Smart Buttons in the mini cart preview, select Yes for Show buttons in mini cart preview.
  12. To show PayPal Smart 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 Smart Buttons on the checkout page. Options: Yes / No
Show buttons on product detail page store view Enable or disable PayPal Smart Buttons on the product detail page. Options: Yes / No
Show buttons in mini-cart preview store view Enable or disable PayPal Smart Buttons in the mini-cart preview. Options: Yes / No
Show buttons on cart page store view Enable or disable PayPal Smart 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 Smart Buttons. Options: Vertical / Horizontal
Color Store View Define color of the Paypal Smart Buttons. Options: Blue / Gold / Silver / White / Black
Shape Store View Define shape of the Paypal Smart Buttons. Options: Rectangular / Pill
Use Default Height Store View Defines if PayPal Smart Buttons use a default height. Options: Yes / No
Height Store View Define height of the PayPal Smart Buttons. Default value: none
Label Store View Define label that appears in the PayPal Smart 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.

On this page