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:
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.
To configure the WooCommerce Stripe Payment Gateway Plugin, go to WooCommerce > Settings > Payments > Stripe (Manage button):
Connect or create a new Stripe account, or skip to the next step if you've already done so:
Then, go to Settings > Edit Account Keys:
You'll then see a view like this, with LIVE and TEST mode options. If the API keys aren't configured already, obtain the corresponding LIVE or TEST mode keys from your Stripe account and paste them into the corresponding boxes.
The WooCommerce Stripe Payment Gateway Plugin should automatically configure your Webhook in Stripe. However, the corresponding Transfer events do not get automatically created, which are necesarry for the Split Pay Plugin to properly make transfers.
To add the proper Transfer Events, go to Stripe > Developers > Webhooks and select the corresponding Webhook, which should look something like this:
Select Update Details from the 3-dot menu on the top right corner:
Under Events to Send, search for transfer and select all 3 Transfer events:
These are the Stripe Webhook events that should be enabled the Split Pay Plugin:
Click Update Endpoint, and then you're done - except it needs to be done in TEST and LIVE modes individually.
TEST and LIVE mode must be configured separately, so be sure to repeat the process above for both modes.
After configuring Webhook Transfer events, navigate to the plugin Settings by hovering over WooCommerce to expand the submenu, then click Split Pay Plugin:
Next, click Synchronize Stripe Accounts:
Stripe accounts connected to your Stripe Platform are synced to the WordPress database for faster search results. If you've connected new Stripe accounts to your platform since the last time the plugin was used, you can click Synchronize Stripe Accounts to update the database. You can optionally Clear Synced Stripe Data, but you will have to update all your connected accounts again.
Once you've synchronized your Stripe accounts, you can now set your transfer values. Continue reading about How to Transfer Payments.
