Frequently Asked Questions
Find answers to common questions about Split Pay Plugin, from setup to troubleshooting.
Getting Started
What plugins are required to use Split Pay Plugin?
You need WooCommerce and the WooCommerce Stripe Payment Gateway plugin installed and active. Split Pay Plugin works alongside these to process transfers via Stripe Connect. You can download the free version from WordPress.org.
How do I set up Split Pay Plugin?
- Configure the WooCommerce Stripe Payment Gateway with your Stripe account.
- Enter your Stripe Platform API keys in Split Pay Plugin > Stripe Configuration.
- Click "Sync Webhook" to configure Stripe webhook events.
- Click "Sync Stripe Connected Accounts" to import your connected accounts.
- Set your transfer values (percentage or fixed amount) in the Transfer Settings.
For detailed instructions, see the Quick Start Guide.
How can vendors connect their Stripe accounts?
With the Pro version, vendors can be invited or allowed to self-register via a vendor login page. Once registered, they can connect their Stripe account to your platform with one click — no additional configuration required. The free version uses default Stripe onboarding.
Technical Requirements
What WordPress and WooCommerce versions are supported?
Split Pay Plugin requires WordPress 5.2.3+, PHP 7.0+, and WooCommerce 3.7.1+. It has been tested up to WordPress 6.9 and is fully compatible with High-Performance Order Storage (HPOS).
What Stripe API permissions are needed?
Your Stripe API keys must have Connect permissions with Balance Transfers Write permission enabled. The plugin also requires webhook events:
transfer.created, transfer.reversed, and transfer.updated.Does Split Pay work with WordPress multisite?
Yes, Split Pay Plugin supports WordPress multisite network activation. Each site in your network can have its own Stripe configuration and transfer settings.
Transfers & Payments
What is the minimum transfer amount?
$1 USD (or the equivalent in your local currency), per Stripe's limitations. Transfers below this amount will not be processed.
Can I transfer payments to Stripe accounts in different countries?
Currently, transfers can only be made to Stripe accounts within your Stripe country/region (e.g., US to US, EU to EU). However, any currency can be accepted for payment. The plugin now displays a currency region warning on the Stripe Configuration tab if any connected account is in a different country than your platform, so you can catch mismatches before they cause issues. Future updates will allow cross-border transfers.
Can I mix percentage and fixed amount transfers?
Yes, with the Pro version. You can sell some products with a percentage split and others with a fixed amount. For example, transfer $10 from sales of Product X and 25% from sales of Product Y.
How do refunds work with Split Pay?
Pro: Refunds are handled automatically. When you issue a full or partial refund in WooCommerce, the plugin creates proportional transfer reversals in Stripe for each connected account. No manual intervention needed.
Free: You must manually reverse transfers in the Stripe Dashboard. This requires sufficient payout balance in the connected account. See the documentation for details.
Free: You must manually reverse transfers in the Stripe Dashboard. This requires sufficient payout balance in the connected account. See the documentation for details.
How do I test transfers before going live?
Use Stripe test mode with the test card number
4242 4242 4242 4242. Configure the plugin with your test API keys and a test connected account. Verify transfers in Stripe Dashboard > Connect > Transfers.
Features
What's the difference between the Free and Pro versions?
The free version includes global percentage-based transfers to a single connected Stripe account and currency agnostic support. The Pro version adds fixed amount transfers, multiple connected accounts, product-level transfers, variable product support, vendor onboarding, shipping and tax transfers, bulk editor, transfer logging with CSV export, confirmation emails, WooCommerce Subscriptions support, Product Bundles, and Advanced Product Fields. See the full comparison.
Can I set different transfer amounts for different products?
Yes, with the Pro version. You can set transfer percentages or fixed amounts globally or override them at the product level. For variable products, you can even set unique transfer values for each variation.
Does it work with WooCommerce Subscriptions?
Yes, the Pro version fully supports the official Woo Subscriptions plugin. Every recurring payment in a subscription automatically triggers the same split transfer as the initial transaction.
Pricing & Billing
Is there a free version available?
Yes! The free version is available on WordPress.org and includes global percentage-based transfers. You can upgrade to Pro at any time for additional features.
What is the refund policy?
All Pro plans come with a 30-day money-back guarantee. If you're not satisfied for any reason, contact us within 30 days for a full refund — no questions asked.
What happens when my Pro license expires?
The plugin PRO features will no longer work, but you can continue to use the free version. You can renew at any time to restore access.
Troubleshooting
I'm getting "Cannot create transfers on behalf of a Standard connected account"
This error means the Stripe account you're trying to transfer to is already connected to another Stripe platform. The connected account needs to be a standalone Stripe account that is only connected to your platform. See the documentation for details on resolving this.
Webhooks are not syncing correctly
If the "Sync Webhook" button fails, you can manually add the required events in your Stripe Dashboard. Go to Developers > Webhooks and add the following events:
transfer.created, transfer.reversed, and transfer.updated. Make sure the webhook URL points to your site.Transfers are not being created after checkout
Check the following: (1) Your API keys have Connect permissions with Balance Transfers Write access, (2) Webhooks are configured correctly, (3) The connected account status is "Complete" (fully activated), (4) The transfer amount meets the $1 minimum, and (5) Your pending payout balance covers the transfer amount. If issues persist, contact support.
Still Have Questions?
Our support team responds within one business day. We're here to help you get set up.