Quick Start

Everything you need to know for getting started with the Split Pay for Stripe Connect on WooCommerce plugin.

Prerequisites

Ensure the following 3 free plugins are installed and activated on your WordPress site:

Setting Up Split Payments

Split Transfers will only work if the following requirements are met:

  • You have fully configured Stripe Webhooks, Webhook Events, and Webhook Secret as described below.

  • Transfer amounts are 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. - International current transfer transfers are not presently supported.

  • 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.

  • Please see our Troubleshooting Guide if you meet all the requirements above and transfers are continuing to fail.

Make sure of the following:

  • That you have fully configured the Stripe connection in the WooCommerce Stripe Payment Gateway plugin, including all Webhook Events and the Webhook Signing Secret in both TEST and LIVE modes. Otherwise, split payment transfers will not work.

  • Ensure the Webhook in Stripe follows the right protocol of http vs https for your site. https is always recommended.

Follow the instructions from WooCommerce on enabling Webhook Events.

These are the Stripe Webhook Events that should be enabled required for use of the Split Pay Plugin:

account.application.authorized
account.application.deauthorized
account.external_account.created
account.external_account.deleted
account.external_account.updated
account.updated

charge.captured
charge.dispute.closed
charge.dispute.created
charge.dispute.funds_reinstated
charge.dispute.funds_withdrawn
charge.dispute.updated
charge.expired
charge.failed
charge.pending
charge.refund.updated
charge.refunded
charge.succeeded
charge.updated

customer.created
customer.deleted
customer.discount.created
customer.discount.deleted
customer.discount.updated
customer.source.created
customer.source.deleted
customer.source.expiring
customer.source.updated
customer.subscription.created
customer.subscription.deleted
customer.subscription.paused
customer.subscription.pending_update_applied
customer.subscription.pending_update_expired
customer.subscription.resumed
customer.subscription.trial_will_end
customer.subscription.updated
customer.tax_id.created
customer.tax_id.deleted
customer.tax_id.updated
customer.updated

payment_intent.amount_capturable_updated
payment_intent.canceled
payment_intent.created
payment_intent.partially_funded
payment_intent.payment_failed
payment_intent.processing
payment_intent.requires_action
payment_intent.succeeded

source.canceled
source.chargeable

transfer.created
transfer.reversed
transfer.updated

It is not required to configure more than the required Webhook Events listed above, otherwise, you may be creating an unnecessary server load, which could negatively impact payment processing:

After configuring the webhook events, navigate to the plugin Settings by hovering over WooCommerce to expand the submenu, then click Split Pay Plugin:

Next, search for or enter the desired Stripe Connect Account ID. The search results come from the Stripe Platform account connected to the WooCommerce Stripe Payment plugin.

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.

Once you've synced your Stripe accounts, you can set your split transfer values. Continue reading about How to Split Payments.

pageHow to Transfer Payments

Last updated