Integrations & Compatibility

FluentCart

Use Split Pay with FluentCart and its built-in Stripe gateway to split FluentCart orders between multiple Stripe Connect accounts. First-class FluentCart support was added in Split Pay 3.7.0.

Overview#

From Split Pay 3.7.0 onward, FluentCart is supported as a first-class e-commerce platform alongside WooCommerce. You do not need WooCommerce installed to use Split Pay with FluentCart; the plugin works with FluentCart standalone.

When a FluentCart order is paid through FluentCart’s built-in Stripe gateway, Split Pay reads the order, looks up the transfer rules you have configured (global or per product), and creates Stripe Transfers from your platform balance to the connected accounts you have selected. Connected accounts are shared with WooCommerce if both platforms are present, so you only need to sync them once.

Compatibility#

  • Split Pay: v3.7.0 or later.
  • FluentCart: any version that exposes the FLUENTCART_VERSION constant and the built-in Stripe payment method. Split Pay detects FluentCart automatically once activated.
  • Stripe gateway: FluentCart’s built-in Stripe payment method. Split Pay does not require the WooCommerce Stripe Payment Gateway when using FluentCart.
  • WordPress: the same requirement as Split Pay (currently WordPress 6.0+).
  • WooCommerce coexistence: FluentCart and WooCommerce can run side by side on the same site. Split Pay will register both integrations and process orders from whichever platform the customer used.

Setup#

Install and activate FluentCart. Configure your FluentCart store, products, and tax rules as you normally would.

Connect FluentCart to Stripe. Go to FluentCart → Settings → Payments → Stripe and connect FluentCart to your Stripe platform account. Repeat the connection independently in both test and live modes if you plan to use both.

Install and activate Split Pay. You can install Split Pay before or after FluentCart — Split Pay will pick FluentCart up automatically.

Open the Integrations tab. In the WordPress admin, click Split Pay (top-level menu). The Integrations tab opens by default. Confirm that the FluentCart card shows the Active badge and that the FluentCart built-in Stripe gateway card appears beneath it. See Integrations Tab for details on what the cards mean.

Paste your Stripe platform-account API keys. Click Settings on the FluentCart Stripe gateway card and enter the Publishable and Secret (or Restricted) keys from your Stripe platform account. Keys must have Connect → Transfers: Write (older Stripe Dashboard versions surfaced this as Balance Transfers: Write). See the Quick Start — Adjusting API Key Permissions section for the exact permissions.

Sync webhooks. Click Sync Webhooks on the FluentCart Stripe gateway card. Split Pay creates the transfer-events webhook (transfer.created, transfer.reversed, transfer.updated) on your Stripe account.

Sync connected accounts. Click Sync Connected Accounts from the summary section to pull your Stripe Connect accounts into Split Pay. These accounts are shared across all integrations.

Configure transfer rules. Open the Main tab to set global transfer rules, or open a FluentCart product’s edit screen to set per-product transfer rules. The Split Pay product panel is added to FluentCart product edit screens by the FluentCart integration.

Run a test order. Place a test order through FluentCart in test mode. After payment succeeds, you should see a corresponding Transfer in your Stripe Dashboard (Connect → Transfers), and the Split Pay Transfers tab should log the transfer with FluentCart in the Source column.

Repeat for live mode when you are ready to ship. Test and live modes are configured independently end-to-end.

The Transfers tab adds a Source column (added in 3.7.0) so you can filter the log by FluentCart vs WooCommerce when both platforms are active on the same store.

Vendor onboarding#

You have two options for getting vendors connected on a FluentCart store:

  • Admin-managed — create connected accounts in your Stripe Dashboard, then assign them to FluentCart products in the Split Pay product panel. See Connecting Vendor Stripe Accounts.
  • Self-service (PRO) — let vendors register and connect their own Stripe accounts using the [split_pay_vendor_connect] shortcode on a public page. The shortcode is platform-agnostic and works the same whether you run WooCommerce, FluentCart, or both. See the shortcode reference.

Limitations and known issues#

  • One Stripe platform per FluentCart install. Split Pay uses the same Stripe platform account FluentCart is connected to for the corresponding mode. If you switch FluentCart’s Stripe connection to a different platform, re-sync webhooks and connected accounts in Split Pay.
  • Test and live are independent. Connecting FluentCart to Stripe in test mode does not automatically configure live mode. You must complete the full setup for each mode separately.
  • Refund handling depends on FluentCart’s refund event. Automatic transfer reversals (PRO) trigger off FluentCart’s refund hook. If a refund is issued directly in the Stripe Dashboard without going through FluentCart, Split Pay will not see it and the transfer will not be reversed automatically. See Refund Handling for the platform-neutral overview.
  • Cross-border transfer rules still apply. Stripe’s minimum transfer amount and same-country / supported-corridor rules are platform-agnostic. See International Transfers.
  • Some WooCommerce-specific developer filters do not apply. Filters such as spp_product_data_tab_classes are WooCommerce-only. FluentCart-specific filters (spp_fc_order_transferable_items, spp_transfer_metadata) and the platform-agnostic spp_before_process_transfers / spp_after_process_transfers actions are available for FluentCart. See Developer Filters.

Troubleshooting#

  • FluentCart card shows Inactive or Not found. Confirm FluentCart is installed and activated. Open FluentCart → Settings → Payments → Stripe and verify Stripe is connected in the mode you are using.
  • Test order completes but no transfer appears. Re-check that you pasted your Stripe platform account API keys (not a connected-account key) into the FluentCart gateway card’s Settings overlay, and that Sync Webhooks reported success.
  • Transfers Tab is missing the Source column. The Source column was added in 3.7.0. Make sure you are running Split Pay 3.7.0 or later.