Quick Start
Everything you need to know for getting started with the Split Pay for Stripe Connect on WooCommerce plugin.
Required Plugins
Ensure the following 3 free plugins are installed and activated on your WordPress site:
Stripe Transfer Limitations
Transfers will only work if the following requirements are met:
You have fully configured Stripe API Keys, Webhook Endpoint, Endpoint Events, and Webhook Secret as described below.
Transfer amounts must be a minimum of $1 USD or local currency equivalent.
Your Connected Stripe accounts are all in the same currency region as your Platform account (e.g. - EUR in Euro area, USD for US). E.g. - Cross-border transfers are not currently allowed by Stripe.
Your Pending Payout Balance will cover the full transfer amount. E.g. - if you are transferring 100% of the purchase, the payout balance may be exceeded by the amount of the transaction fees.
Your Stripe account is not connected to another Stripe Platform, such as WooCommerce, otherwise transfers will get this error.
Please see our Troubleshooting Guide if you meet all the requirements above and transfers are continuing to fail.
Configuring the WooCommerce Stripe Payment Gateway Plugin
If you've already connected the WooCommerce Stripe Payment Gateway plugin in both TEST and LIVE modes, please proceed to Configuring the Split Pay Plugin below.
To configure the WooCommerce Stripe Payment Gateway Plugin, go to WooCommerce > Settings > Payments > Stripe (Manage button) > Settings Tab:
The direct link should look something like this (be sure to adjust your-domain.com to your domain):
Go to the Settings tab:
Then, connect or create a new Stripe account, or skip to the next step if you've already done so:
When you connect Stripe, a Webhook Endpoint is created in your Stripe Dashboard, which helps track payment events between WooCommerce and Stripe.
Click the link below to see your Webhook Endpoint in TEST mode. You may need this for Troubleshooting later.
The new Webhook Endpoint should look something like this:
Configuring the Split Pay Plugin
Go into the Split Pay Plugin Stripe Configuration settings under WooCommerce > Split Pay Plugin > Stripe Configuration.
Then, enter the API keys from your Stripe account for TEST and LIVE modes separately:
Be sure your API keys have the proper Connect permissions enabled for your API keys. See Adjusting API Key Permissions below.
Syncing Webhooks
The Split Pay Plugin requires 3 Transfer Events configured in the Stripe Webhook. You can attempt to sync them automatically by clicking Sync Webhook in the Split Pay Plugin Settings:
If either of the options fail, please continue to Webhook Sync Failures below. Otherwise, proceed to Sync Connected Stripe Accounts.
Sync Connected Stripe Accounts
Next, click Sync Stripe Connected Accounts.
If you don't have any Stripe Accounts connected yet, you can connect or create new accounts. Having at least one accounted connected in each TEST or LIVE mode is required to proceed.
Synced Stripe accounts are stored in the WordPress database for faster access and can be cleared by clicking Clear Synced Stripe Data. This will require reconfiguring all connected accounts in the Split Pay Plugin settings.
If you've completed all the steps above and everything is looking good, please proceed to How to Transfer Payments to start configuring transfer settings.
Webhook Sync Failures
Proceed with these steps below if you see a red ❌ when attempting to sync webhooks:
If the Split Pay Plugin Webhook Sync fails, it could be because of the following reasons:
You may not have connected Stripe in both TEST and LIVE modes in the WooCommerce Stripe Plugin Payment Settings. Go to Configuring the WooCommerce Stripe Payment Gateway Plugin above and ensure both TEST and LIVE mode have the same exact account configured/connected.
Transfer events on the TEST or LIVE mode webhooks may not be set up correctly. See Updating Transfer Events below.
Your API keys may not have the correct permissions. See Adjusting API Key Permissions below.
You may have used API keys from one of your connected Stripe accounts instead of your Stripe Platform account. Be sure to use your Stripe Platform account API keys and not the API keys of any of your connected accounts.
The API keys may not be properly copied/pasted. Be sure to double check your API keys for consistency.
Updating Transfer Events
You can attempt to manually configure your Stripe Webhook Events by following these instructions:
Go to the 3-dot menu on the top right corner and select Update details...
Add these 3 transfer events and click Update Endpoint
Be sure to configure the TEST and LIVE webhook events individually.
Next, return to the steps above for Configuring the Split Pay Plugin.
Adjusting API Key Permissions
After creating an API key, make sure it shows the "Connect" badge on the right side of the API key name in both TEST and LIVE modes:
If it does not show the badge, edit the API key:
Then, on the top of the page under the Connect Permissions column, find the Balance Transfers row and enable the Write permission:
Be sure to click Apply Changes.
Next, return to the steps above for Configuring the Split Pay Plugin.
Last updated
