Connecting vendor Stripe accounts

Overview#

Before Split Pay can transfer funds to a vendor, that vendor must have a Stripe account connected to your platform. There are three ways to connect vendor accounts:

1. Split Pay onboarding PRO — A built-in registration and onboarding flow on your site’s standard WordPress registration page.
2. Front-end shortcode — The [split_pay_vendor_connect] shortcode renders a “Connect with Stripe” button on any page so vendors can onboard without touching wp-admin.
3. Stripe Dashboard onboarding — Manually create connected accounts through your Stripe Dashboard and share an onboarding link.

Once vendors can connect, Split Pay can make the rest hands-off — auto-create a product, give each vendor a payment QR code, email vendors after successful transfers, and send customers one confirmation when their order’s money is sent. See Vendor Automation PRO.

---

Method 1: Split Pay onboarding PRO#

The Pro version includes a self-service onboarding flow that lets vendors register and connect their Stripe accounts without you needing to touch the Stripe Dashboard.

Enable vendor onboarding

When enabled, the plugin creates a Vendor (Split Pay Plugin) WordPress user role and adds a Register as a Vendor checkbox to your site’s existing WordPress registration page. No new page is created.

WordPress opens that registration page only when Anyone can register is checked under Settings → General → Membership. If your site keeps public registration off, add vendors yourself as described in Managing vendors.

Vendor registration flow

Once onboarding is enabled, vendors can self-register:

Additional vendor roles

In the Vendor Onboarding settings tab, the Additional Vendor Roles multi-select lets you grant any WordPress role access to the Stripe Connect onboarding page. This is useful when your site already has custom roles (for example, “Seller,” “Artist,” or “Partner”) and you want those users to connect their Stripe accounts without changing their existing role.

Vendor instructions: title and description

You can show vendors your own instructions next to the Stripe Connect button. On the Vendor Onboarding tab, with vendor onboarding enabled, check Enable Title & Description., enter a Title and a Description, and save. Vendors see them at the top of their Stripe Connect page in WordPress admin, above the button to connect their Stripe account. Vendors land on that page when they log in.

If the option is off or a field is blank, vendors see the default heading Stripe Connect Settings and the default text Please connect your Stripe account. Both fields are plain text. Keep them short, for example a title of Stripe Connect Settings and a description such as Please connect your Stripe account. Contact us at [email protected] with any questions.

Managing vendors

Vendors who registered through the built-in flow appear in your WordPress Users list with the Vendor (Split Pay Plugin) role. Use Connect Status to verify the exact connected-account ID and Stripe mode before configuring product-level transfers.

New onboarding and strict 3.8.4 identity routing use exact, site-scoped Test/Live pairs. Existing 3.8.3 installations keep their legacy email, then name, then saved-ID resolution until an administrator confirms an exact pair or completes a strict platform-key replacement.

You can also add a vendor yourself, which is the way to do it when your site does not allow public registration. With vendor onboarding enabled, go to Users → Add New User, enter the vendor’s details, and choose the Vendor (Split Pay Plugin) role. When that vendor logs in, they land on the same Stripe Connect page to connect their account.

---

Method 2: front-end vendor onboarding shortcode#

The [split_pay_vendor_connect] shortcode renders a Stripe Connect onboarding button on any public page. Vendors can start or resume onboarding without you exposing the WordPress registration page or admin dashboard. The shortcode works on a WooCommerce site, a FluentCart site, or a hybrid site.

The shortcode reuses the same Stripe Connect account and account-link flow as Method 1. Once a vendor completes onboarding, Split Pay stores the account ID in this site’s mode-specific connection record and can route transfers to it.

Syntax

Drop the shortcode into any post, page, widget, or template that accepts shortcodes:

[split_pay_vendor_connect]

All four attributes are optional. You can override any subset:

[split_pay_vendor_connect
  button_label="Become a Vendor"
  connected_label="Your Stripe account is connected."
  login_label="Please log in to connect your Stripe account."
  pending_label="Stripe onboarding is in progress. Complete the steps with Stripe to finish."]

Attributes

Runtime states

The shortcode renders one of four states based on the current user:

1. Logged out — spp-vendor-connect spp-vendor-connect--logged-out wrapper. Shows login_label and a Log In button.
2. Logged in, no Stripe account yet — spp-vendor-connect spp-vendor-connect--connect wrapper. Shows the primary button_label button. Clicking it creates the Standard or Express account selected under Vendor account type by default, generates an account link, and redirects the vendor to Stripe’s hosted onboarding.
3. Logged in, onboarding pending — spp-vendor-connect spp-vendor-connect--pending wrapper. Shows pending_label and a Resume Stripe Onboarding button that re-opens the existing Stripe account link.
4. Logged in and connected — spp-vendor-connect spp-vendor-connect--connected wrapper. Shows connected_label, an optional payment QR code when enabled, and a Disconnect Stripe account button.

You can style any of these states using the wrapper class names listed above.

Where to place it

• A dedicated Become a Vendor landing page on your site.
• The vendor’s profile or dashboard page (an account-area template).
• Inside a sidebar widget on pages where you want to recruit vendors.
• Anywhere the standard WordPress shortcode runner is invoked — including FluentCart product pages, WooCommerce account pages, and Gutenberg/Classic-Editor content.

Required capabilities and configuration

• Visitor: by default, any logged-in WordPress user can use the connect button; the shortcode does not require the Vendor (Split Pay Plugin) role. If the optional identity-bound WCFM Connect flow is enabled, it instead requires an authorized, signed-in WCFM vendor.
• Site administrator: Save the mode-matched Stripe platform secret key on Split Pay → Integrations. If Split Pay cannot resolve a key for that mode, the connect action returns “Stripe is not yet configured by the site administrator” and creates no account.
• HTTPS: Stripe Connect onboarding URLs only function over HTTPS. Make sure your site is served with a valid TLS certificate before pointing vendors at the page.

Example

A minimal “Become a Vendor” page might contain:

<h1>Join the marketplace</h1>
<p>Sign up and connect your Stripe account to start receiving payouts.</p>
[split_pay_vendor_connect button_label="Become a Vendor"]

On the same page you can customise the messaging for other states without changing markup:

[split_pay_vendor_connect
  button_label="Connect Stripe"
  connected_label="You’re all set — payouts will land in your Stripe account."
  login_label="Log in to start your vendor onboarding."
  pending_label="Almost there — finish your Stripe verification."]

Operational notes

• Connect actions hit connect.stripe.com on Stripe’s hosted onboarding. Don’t whitelist a different domain in any security plugins you have running.
• Each connect action carries a one-time nonce (_spp_connect_nonce). Don’t cache the page output too aggressively or vendors may receive an “Invalid request” error if the nonce expires before they click.
• New accounts created by the shortcode, a Split Pay Connect link, or built-in/admin onboarding use the saved Vendor account type setting by default. Standard is the default. Any previously saved choice is still honored, and developer code can override the creation arguments. Changing the setting does not convert an account that already exists. See Vendor account types.

---

Method 3: Stripe Dashboard onboarding#

With the free version (or if you prefer manual control), you can create connected accounts directly through the Stripe Dashboard.

Account requirements#

Regardless of which method you use, connected accounts must meet these requirements before they can receive transfers:

• The account must have completed Stripe onboarding (identity verification, banking details, etc.).
• The account must be enabled for transfers — Stripe may require additional verification for some account types or countries.
• The account must be connected to your platform’s Stripe account (not a different platform).
• Stripe controls cross-border eligibility. Split Pay does not treat a fixed list of countries as a guarantee. Verify a different-country platform/account pairing in Stripe and with a Test order before using it in Live mode.

Finding the Stripe account ID#

Every connected Stripe account has a unique identifier that starts with acct_. You can find it in:

• Stripe Dashboard: Go to Connect → Accounts, click on the account, and the ID appears at the top of the page.
• Vendor user profile on a single-site install: Split Pay mirrors the site connection there for compatibility. On multisite, use Connect Status or Stripe Dashboard instead because Split Pay does not write site identity into network-shared user metadata.