Quick Start
Everything you need to know for getting started with the Split Pay for Stripe Connect on WooCommerce plugin.
Last updated
Everything you need to know for getting started with the Split Pay for Stripe Connect on WooCommerce plugin.
Last updated
Required Plugins
Ensure the following 3 free plugins are installed and activated on your WordPress site:
If you've already connected the WooCommerce Stripe Payment Gateway plugin in both TEST and LIVE modes, please proceed to 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:
The new Webhook Endpoint should look something like this:
Go into the Split Pay Plugin Stripe Configuration settings under WooCommerce > Split Pay Plugin > Stripe Configuration.
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:
Next, click Sync Stripe Connected Accounts.
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.
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 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.
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.
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.
Then, enter the from your Stripe account for and modes separately:
Be sure your API keys have the proper Connect permissions enabled for your API keys. See below.
If either of the options fail, please continue to below. Otherwise, proceed to Sync Connected Stripe Accounts.
If you don't have any Stripe Accounts connected yet, you can . Having at least one accounted connected in each TEST or LIVE mode is required to proceed.
If you've completed all the steps above and everything is looking good, please proceed to to start configuring transfer settings.
You may not have connected Stripe in both TEST and LIVE modes in the WooCommerce Stripe Plugin Payment Settings. Go to 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 below.
Your API keys may not have the correct permissions. See below.
Click into the new Stripe Webhook (here are the links for your list of mode Webhooks and mode Webhooks). It should be formatted like this:
Next, return to the steps above for .
Next, return to the steps above for .
