Frequently Asked Questions
Why aren't my payment methods showing on the checkout page?
The most common reason payment methods disappear from checkout is a currency switcher plugin. These plugins hide PayPal payment options when customers select currencies that PayPal doesn't support.
Currency switcher plugins automatically hide payment methods to prevent checkout errors when unsupported currencies are selected. PayPal supports over 25 currencies including USD, EUR, GBP, CAD, AUD, and JPY.
To fix this, configure your currency switcher plugin to specify which payment methods work with each currency. Match PayPal's supported currencies with your switcher plugin's currency options, and PayPal will appear only when compatible currencies are selected.
Does your plugin support WooCommerce Subscriptions?
Yes, the plugin fully supports WooCommerce Subscriptions for recurring payments. This allows customers to set up automatic billing for subscription products using their PayPal account.
If you encounter permissions errors when processing subscription payments, the issue is typically that your PayPal account doesn't have the "Vault" feature enabled. The Vault feature allows PayPal to securely store customer payment information for future recurring charges.
To enable the Vault feature, contact PayPal support or check your PayPal business account settings. Once enabled, subscription payments will process automatically without requiring customers to re-authorize each payment.
Does this PayPal plugin support the block cart and block checkout?
Yes, this PayPal plugin fully supports both WooCommerce's block cart and block checkout pages. You can use PayPal payment methods with the modern block-based checkout experience without any issues.
If you see notices within WooCommerce suggesting that the plugin doesn't support blocks, these messages are inaccurate. The plugin has been updated to work seamlessly with WooCommerce's block-based cart and checkout pages.
The plugin automatically detects whether you're using the classic or block-based checkout and adjusts accordingly, ensuring PayPal payment options appear correctly in both environments.
The credit card form is not rendering on my checkout page
If the credit card form isn't appearing at checkout, it's likely because Advanced Card Processing isn't enabled for your PayPal account. This feature allows customers to enter their credit card details directly on your checkout page instead of being redirected to PayPal.
When Advanced Card Processing is disabled, you'll see a notice explaining that the feature isn't available. If you're logged in as an admin, this notice includes step-by-step instructions for enabling the feature in the PayPal Developer Portal.
To enable Advanced Card Processing, log into developer.paypal.com, navigate to Apps & Credentials, click your application, and under "Features" check "Advanced Card Processing". Once enabled, the credit card form will appear on your checkout page.
What is the difference between the PayPal Vault and Billing Agreements/Reference Transactions?
Billing Agreements and Reference Transactions were PayPal's original method for storing customer payment information for recurring charges like subscriptions. These features allowed merchants to charge customers automatically without requiring re-authorization for each payment.
Since version 1.1.0, the PayPal plugin has supported PayPal's newer Vault feature, which serves the same purpose but with improved security and functionality. The Vault is PayPal's modern approach to storing payment methods for future transactions.
The plugin uses Vault by default, which you can find enabled in the Advanced Settings page. If Vault is disabled or unavailable for your account, the plugin automatically falls back to the older Billing Agreements system to ensure recurring payments continue working seamlessly.