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

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):

https://your-domain.com/wp-admin/admin.php?page=wc-settings&tab=checkout&section=stripe&panel=settings
Activate Stripe

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:

Create or Connect a New Stripe Account

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.

https://dashboard.stripe.com/test/webhooks

The new Webhook Endpoint should look something like this:

Stripe Webhook Endpoints

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:

Stripe API Keys Configuration in the Split Pay Plugin

Be sure your API keys have the proper Connect permissions enabled for your API keys. See Adjusting API Key Permissions below.

Syncing Webhooks

Sync Webhook for Transfer Events

Sync Connected Stripe Accounts

Next, click Sync Stripe Connected Accounts.

Sync Connected Stripe Accounts and Configure Transfer Settings
Connecting Vendor Stripe Accounts
How to Transfer Payments

Webhook Sync Failures

Proceed with these steps below if you see a red ❌ when attempting to sync webhooks:

Sync Webhook Failure
  • 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:

  1. Click into the new Stripe Webhook (here are the links for your list of TEST mode Webhooks and LIVE mode Webhooks). It should be formatted like this:

https://your-site.com/?wc-api=wc_stripe
  1. Go to the 3-dot menu on the top right corner and select Update details...

Update Webhook Details
  1. Add these 3 transfer events and click Update Endpoint

transfer.created
transfer.reversed
transfer.updated
Transfer Events

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:

API Key Displaying "Connect" Badge

If it does not show the badge, edit the API key:

Edit API Key Permissions

Then, on the top of the page under the Connect Permissions column, find the Balance Transfers row and enable the Write permission:

Enable Connect Write Permissions

Be sure to click Apply Changes.

Next, return to the steps above for Configuring the Split Pay Plugin.

Last updated