Running a marketplace on HivePress where buyers pay vendors requires a different payment setup than simple listing fees. When a buyer pays for a service, the money needs to flow to the vendor minus your platform commission. Stripe Connect is the payment infrastructure that makes this work. This guide covers the complete Stripe Connect setup for HivePress marketplace payouts, including the vendor onboarding process, commission configuration, and the escrow flow that protects both buyers and vendors.
Understanding Stripe Connect for Marketplaces
Standard Stripe (where you have one Stripe account and collect all payments) does not work for marketplace payouts. You cannot simply collect a customer’s payment into your account and then send money to dozens of different vendors – that is money transmission, which requires specific financial licences in most jurisdictions.
Stripe Connect solves this by creating connected accounts for each vendor under your Stripe platform account. When a buyer pays, Stripe routes the money directly: the vendor’s share goes to the vendor’s connected account, and your commission stays in your platform account. Stripe handles the regulatory compliance for this routing. Your HivePress site is the platform; your vendors are connected accounts.
There are two types of Stripe Connect accounts relevant to HivePress: Express accounts (faster vendor onboarding, Stripe handles KYC verification and payout scheduling) and Standard accounts (vendors create their own full Stripe account and connect it to your platform). HivePress’s Marketplace extension uses Stripe Express by default, which is the right choice for most marketplace setups.
Step 1: Configure Stripe Platform Account
If you do not already have a Stripe account, create one at stripe.com. Your platform account is your marketplace’s Stripe account – the one where your commission revenue accumulates. In the Stripe Dashboard, go to Settings -> Connect Settings. Enable Stripe Connect for your account. Configure your platform’s branding (name, logo) that vendors see during the Express onboarding flow. Set the payout schedule for connected accounts – when vendors receive their money after a completed transaction.
Go to Stripe Dashboard -> Developers -> API Keys and copy your publishable key and secret key. You also need the Connect Webhook Secret, which you configure later. Keep these in a secure location – do not commit them to version control or share them.
Step 2: Install HivePress Marketplace Extension
The HivePress Marketplace extension handles the Stripe Connect integration. Purchase and install it from HivePress’s extension library. After activation, go to HivePress -> Settings -> Marketplace. Enter your Stripe publishable key and secret key. Set your platform commission percentage – this is the percentage you keep from each transaction. Common marketplace commissions range from 10% (competitive, vendor-friendly) to 30% (common for software tools and professional marketplaces).
Configure the payout delay – how many days after a completed order before funds are released to the vendor. A delay of 7-14 days gives you time to handle disputes before money leaves the platform. Buyers who dispute a transaction during the delay period allow you to intervene before the vendor is paid. After the delay, Stripe automatically transfers funds to the vendor’s connected account.
Want this built properly from the start? Describe what you need and get a free estimate.
Step 3: Configure Stripe Webhooks
Stripe webhooks notify HivePress when payment events occur – payment succeeded, payout completed, account updated. Without webhooks, HivePress does not know when Stripe events happen and cannot update order statuses or vendor balances accordingly.
In Stripe Dashboard -> Developers -> Webhooks, click “Add endpoint”. Enter your webhook URL in the format: https://yourdomain.com/wp-json/hivepress/v1/stripe/webhook. Select the events to listen for: payment_intent.succeeded, payment_intent.payment_failed, account.updated, payout.paid, payout.failed. Save the endpoint and copy the Signing Secret that Stripe generates. Enter this signing secret in HivePress -> Settings -> Marketplace -> Stripe Webhook Secret.
Test the webhook by going to Stripe Dashboard -> Developers -> Webhooks -> your endpoint -> Send test webhook. Select payment_intent.succeeded and send. In HivePress logs or your WordPress debug log, verify the webhook was received and processed without errors.
Step 4: Vendor Stripe Express Onboarding
Vendors must complete Stripe Express onboarding before they can receive payouts. The first time a vendor tries to withdraw earnings from their HivePress dashboard, HivePress redirects them to Stripe’s Express onboarding flow. Vendors enter their personal information, bank account details, and complete Stripe’s KYC (Know Your Customer) verification.
Stripe Express onboarding typically takes 5-10 minutes for vendors in supported countries. After completion, the vendor’s connected account is active and future payouts flow automatically. Vendors can access their Express dashboard through a link in their HivePress account to see their balance, payout history, and manage their bank account.
Not all countries are supported for Stripe Express. Check Stripe’s supported countries list before launching your marketplace if you expect international vendors. For countries where Express is not available, Stripe Standard accounts are an alternative but require more complex configuration.
Step 5: The Complete Transaction Flow
Understanding the full flow from buyer payment to vendor payout helps you troubleshoot and explain the process to vendors:
- Buyer selects a service and proceeds to checkout. HivePress creates a Stripe payment intent.
- Buyer enters card details. Stripe charges the buyer’s card for the full service amount.
- Stripe holds the funds. Your platform’s commission is immediately available to you. The vendor’s portion is held pending.
- The order is marked as completed (either automatically or after manual confirmation that the service was delivered).
- After your configured payout delay, Stripe automatically transfers the vendor’s portion to their connected account.
- Stripe pays out to the vendor’s bank account on their Express account’s payout schedule (typically weekly or daily based on their Stripe Express settings).
Handling Refunds and Disputes
Refunds in a Stripe Connect marketplace are more complex than single-account refunds. When you refund a buyer, Stripe reverses the buyer charge. If the vendor has already been paid out, Stripe debits their connected account to fund the refund – the vendor’s balance goes negative until the next transaction. Configure HivePress’s refund policy in settings to align with your payout delay: if you refund within the payout delay window, the vendor was never paid and no clawback is needed. If you refund after payout, Stripe handles the clawback automatically but vendors may dispute this.
Write clear marketplace terms that specify your refund policy and that vendors agree that Stripe can debit their connected account for refunds on disputed transactions. This is standard for marketplaces but vendors should understand it before they start receiving payments.