Making payment methods dependent on shipping options

If you want to limit the availability of payment methods based on a specified shipping option, shipping country or a different attribute from the shopping cart, you need to customize the PaymentOptionInfoProvider class from the CMS.Ecommerce namespace.

The following example disables the PayPal payment method when the customer selects USA in the shipping address or selects USPS as the shipping option.

Prepare an assembly (Class Library project) with class discovery enabled in your Xperience solution (or use an existing one). See Adding custom assemblies. - Reference the project from both your live site and Xperience administration (CMSApp) projects.

Continue by creating a custom implementation of the PaymentOptionInfoProvider class:

1. Add a new class under the custom project, for example named CustomPaymentOptionInfoProvider.

2. Make the class inherit from the PaymentOptionInfoProvider class.

3. Register the custom provider class using the RegisterCustomProvider assembly attribute.

4. Override the provider’s IsPaymentOptionApplicableInternalmethod:

   Copy

   
   
   
    using System;
   
    using CMS;
    using CMS.Ecommerce;
    using CMS.Globalization;
   
    [assembly: RegisterCustomProvider(typeof(CustomPaymentOptionInfoProvider))]
   
    public class CustomPaymentOptionInfoProvider : PaymentOptionInfoProvider
    {
        protected override bool IsPaymentOptionApplicableInternal(ShoppingCartInfo cart, PaymentOptionInfo paymentOption)
        {
            // Does not check availability if the shopping cart or payment option is not available
            if ((cart == null) || (paymentOption == null))
            {
                return true;
            }
   
            // Allows all payment methods except for PayPal
            if (!paymentOption.PaymentOptionName.Equals("PayPal", StringComparison.InvariantCultureIgnoreCase))
            {
                return true;
            }
   
            // Disables PayPal if the billing address is within the USA
            if (cart.ShoppingCartBillingAddress != null)
            {
                CountryInfo country = CountryInfo.Provider.Get(cart.ShoppingCartBillingAddress.AddressCountryID);
                if ((country != null) && 
                    country.CountryThreeLetterCode.Equals("USA", StringComparison.InvariantCultureIgnoreCase))
                {
                    return false;
                }
            }
   
            // Disables PayPal if the USPS shipping method is selected
            return (cart.ShippingOption == null) ||
                !cart.ShippingOption.ShippingOptionName.Equals("USPS", StringComparison.InvariantCultureIgnoreCase);
        }
    }
   
   
    

5. Save all changes and Build the custom project.

If a customer now selects USA as the country in their billing address or selects USPS as their shipping option, they will not be able to use PayPal as the payment method.