Deprecated functionality
This page lists features in the PayPal plugin that have been deprecated over time. Deprecated features are no longer recommended for use and may be removed in future versions. Developers are advised to transition to newer alternatives as soon as possible.
Feature name: Legacy Pay Later messaging configuration
Purpose: Allows merchants to configure Pay Later messaging style & locations.
Issue/PR: #2096
Reason for Deprecation: PayPal provided a new feature with a JavaScript package - Pay Later messaging configurator
Alternative: The new Pay Later messaging configurator replaces the old functionality. Use this snippet to restore the legacy configuration:
add_filter( 'woocommerce.feature-flags.woocommerce_paypal_payments.paylater_configurator_enabled', '__return_false' );
Documentation:
Click to reveal feature documentation
Pay Later MessagingPay Later messaging lets your buyers know they can buy now and pay later, if they check out with PayPal. Adding messaging to your website can help improve conversion, attract new customers, and increase order values.
Pay Later messages are dynamic, enabling you to show your customers their specific Pay Later offer, based on the contents of their shopping cart.
By default, the following Pay Later Messaging Locations are available:
Single Product
Cart
Checkout
Shop (includes Search & Product Categories pages)
Home
The messaging can be configured in the text format with these settings
Messaging layout – The layout of the Pay Later message.
Messaging logo – What logo does the Pay Later message contain. Only applicable when the Text layout style is selected.
Messaging logo position – The position of the Pay Later logo. Only applicable, when the Text layout style is selected.
Messaging text color – The color of the text. Only applicable, when the layout style Text is used.
Messaging layout – The layout of the Pay Later message. Messaging Color – The color of the banner. Only applicable, when the layout style Banner is used. Messaging Ratio – The width/height ratio of the banner. Only applicable, when the layout style Banner is used. Pay Later messaging customization options are explained here.
Customize Messaging Per Location
By default, all Pay Later Messaging locations share the same styling configuration. The Customize Messaging Per Location setting enables customizations to the messaging for each enabled location.
Feature name: Payment vaulted checker functionality
Purpose: Checks if the buyer has a saved payment token before capturing subscription payments (WooCommerce Subscriptions & PayPal Vaulting).
Issue/PR: #1711
Reason for Deprecation: Compatibility issues. In some cases was causing subscription payments to fail despite payment token being present.
Alternative: No alternative. This functionality was moved into a separate module from where it can still be enabled with a filter.
add_filter('woocommerce.deprecated-flags.woocommerce_paypal_payments.saved_payment_checker_enabled', '__return_true');
OR
putenv( 'PCP_SAVED_PAYMENT_CHECKER_ENABLED=1' );
Documentation:
Click to reveal feature documentation
When using the payment token checker, the configured Intent setting, will be disregarded for subscription products, which will be handled with payment authorizations. When the customer completes the subscription payment, the payment is first authorized, and a WooCommerce order is created in the “On-hold” status. If the intent Capture is configured, the authorized payment may be captured automatically within three minutes. During this time, a webhook should be received, which confirms whether or not the payment method was successfully saved in the PayPal Vault.
The subscription payment is automatically captured if the intent is configured with Capture and the payment method was successfully saved in the PayPal Vault. The payment authorization can be captured manually while waiting for the webhook confirmation, but this is not recommended. If the intent is configured with Capture and the payment method could not be saved in the PayPal Vault, the behavior is determined with the Subscription capture behavior if Vault fails setting.
Saving a payment method in the Vault may fail under certain circumstances. The Subscription capture behavior if Vault fails option determines how these failure scenarios are handled. The default configuration prevents subscription payments when the payment method was not saved in the Vault.
- Void authorization & fail the order/subscription (default): The authorized subscription payment is voided, and the order is set to Failed. This configuration prevents subscription signups and payments without a saved payment method. In this case, subscription orders would fail with the message “Could not process order because it was not possible to save the payment on PayPal. Order status changed from On hold to Failed.“
- Capture authorized payment & set subscription to Manual Renewal: The authorized subscription payment is captured, and the subscription activates but is set to Manual Renewal. The failure to save the payment method is logged in an order note, and the payment confirmation mail for the customer includes additional information. The customer has to manually confirm the renewal payment until a new payment method was saved in the Vault. Once a payment method was saved in the Vault, the subscription payment method could be changed to automatically renew via PayPal Payments.
- Capture authorized payment & disregard missing payment method: The authorized subscription payment is captured, and the subscription activates. The failure to save the payment method is disregarded, and WooCommerce Subscriptions will attempt to renew the subscription at the scheduled date. If no payment method was saved in the Vault by the time of the renewal, the automatic renewal payment would fail due to the lack of a saved payment method. Automatic subscription renewal payments require a payment method saved in the Vault.