How to Build a Payment System for a Multi-Vendor Marketplace

Standard payment processing is straightforward: customer pays, you receive money. Marketplace payments add a layer of complexity that trips up even experienced teams. Money flows from buyer to platform, then from platform to seller, minus your commission. And that is the simple version.

Consider the edge cases: a buyer purchases from three different sellers in one cart. One seller ships late and the buyer wants a partial refund. Another seller's item is defective and the buyer disputes the charge. The third seller is in Germany and needs to be paid in euros. Oh, and you need to handle sales tax for each seller's jurisdiction separately.

This is not theoretical. Every marketplace deals with these scenarios within the first few months of operation. The architecture decisions you make on day one determine whether these scenarios are manageable or catastrophic.

Stripe Connect is the de facto standard for marketplace payments. Uber, Shopify, Instacart, and DoorDash all use it. It handles the regulatory complexity of moving money between parties so you do not have to become a licensed money transmitter.

Three Integration Models

Standard Connect: Sellers create their own Stripe accounts through a Stripe-hosted onboarding flow. Simplest to implement. Best for marketplaces where sellers are established businesses with their own bank accounts.

Express Connect: Sellers onboard through a simplified Stripe-hosted flow, but their accounts are managed by your platform. Best balance of simplicity and control. Our recommendation for most marketplaces.

Custom Connect: You build the entire onboarding UI and manage seller accounts directly through the API. Maximum control, maximum complexity. Only choose this if you have specific UX requirements that Express does not satisfy.

How Money Flows

When a buyer makes a purchase, the payment goes to your platform's Stripe account. You specify how much goes to the seller (the transfer amount) and how much stays with the platform (your commission). Stripe handles the split automatically using its payment intents and transfer APIs.

Example: buyer pays $100. Your platform takes a 15% commission ($15). Stripe deducts its processing fee (2.9% plus $0.30, so $3.20). The seller receives $81.80. This math happens automatically for every transaction.

Before sellers can receive payouts, they must complete Know Your Customer (KYC) verification. This is a legal requirement, not a Stripe policy. Anti-money laundering regulations require identity verification for anyone receiving funds through a payment platform.

What Sellers Need to Provide

• Legal name and date of birth
• Social Security Number (US) or equivalent tax ID
• Bank account for payouts
• Business information (if applicable): business name, EIN, address
• Identity verification document (for some sellers, based on risk assessment)

Making Onboarding Smooth

Seller onboarding friction is the #1 killer of marketplace growth. Every extra step in onboarding loses 10 to 20% of potential sellers. Use Stripe's Express or hosted onboarding to minimize your development work and maximize conversion.

Allow sellers to list items before completing full KYC verification. Require verification only before their first payout. This lets sellers experience the platform and see demand before providing sensitive information. Many marketplaces see 2x to 3x higher seller conversion with this deferred verification approach.

Your commission structure directly affects your unit economics and seller satisfaction. Get it wrong and sellers leave for platforms with better terms.

Common Commission Models

• Percentage commission (10 to 30%): The most common model. Etsy charges 6.5%. Airbnb charges hosts 3% and guests 14%. Uber takes 25 to 30%. Your rate depends on the value you add (demand generation, trust, logistics).
• Flat fee per transaction ($1 to $5): Works for high-volume, low-value transactions. Less common in marketplace contexts.
• Subscription plus reduced commission: Sellers pay a monthly fee ($20 to $100) for lower commission rates. Etsy Plus works this way. Good for retaining high-volume sellers.

Implementation with Stripe Connect

Use Stripe's application_fee_amount parameter when creating payment intents. Set your commission as either a fixed amount or calculate the percentage in your application logic before passing it to Stripe. For variable commissions (different rates for different product categories or seller tiers), calculate the fee server-side and pass the absolute amount to Stripe.

Multi-Seller Carts

When a buyer purchases from multiple sellers in a single checkout, you have two options. Option one: create separate payment intents for each seller's items. The buyer sees one charge per seller on their statement. Simpler to implement but potentially confusing for buyers who see multiple charges. Option two: create a single payment intent and use Stripe's transfer API to split the funds to each seller after the payment succeeds. The buyer sees one charge. More complex but better UX.

Marketplace refunds are complicated because the money has already been split. When a buyer requests a refund, who pays: the seller, the platform, or both?

Refund Policies

Define your refund policy clearly before launch. Common approaches:

• Seller-funded refunds: The refund comes from the seller's balance. Your platform commission is also refunded (or not, depending on your policy). Stripe supports reversing transfers to connected accounts.
• Platform-funded refunds: Your platform absorbs the refund cost. Use this for goodwill gestures or when the seller is unresponsive. Budget 1 to 3% of GMV for platform-funded refunds.
• Split refunds: The seller refunds their portion, and the platform refunds its commission. This is the fairest approach and what most established marketplaces use.

Escrow and Delayed Payouts

For service marketplaces (freelancing, home services, tutoring), hold funds in escrow until the service is delivered and the buyer confirms satisfaction. Stripe Connect supports this through delayed transfers. Payment is collected immediately, but the transfer to the seller is not initiated until you trigger it via API.

Set a reasonable escrow period (3 to 14 days after delivery) with an auto-release mechanism. If the buyer does not raise an issue within the window, funds release automatically. This protects buyers while ensuring sellers get paid promptly.

Handling Disputes

Chargebacks on marketplace transactions are messy. The buyer disputes the charge with their bank. Stripe debits your platform account. You need to recover the funds from the seller. Build automated dispute handling: notify the seller, collect evidence, submit to Stripe, and manage the financial reconciliation regardless of the outcome.

Sellers care about one thing above all else: getting paid. Payout speed and reliability directly affect seller retention.

Payout Schedules

Stripe Connect supports multiple payout schedules: daily, weekly, monthly, or manual. For new marketplaces, start with weekly payouts. This gives you a buffer to handle refunds and disputes before money leaves your platform. As you build trust and volume, offer daily payouts as a seller benefit.

Instant Payouts

Stripe offers Instant Payouts that deliver funds to sellers within minutes (for an additional 1% fee). This is a powerful seller incentive. Many marketplaces charge sellers the 1% fee directly, making it a revenue stream. Uber and Lyft both offer instant payouts as a premium feature.

Multi-Currency

If your marketplace operates internationally, you need to handle currency conversion. Stripe converts automatically, but the conversion fee (1% on top of the exchange rate) adds up. For high-volume international marketplaces, consider creating connected accounts in each seller's local currency to avoid conversion fees.

Present prices to buyers in their local currency. Store prices in the seller's currency and convert at checkout using Stripe's real-time exchange rates. Display the conversion rate transparently to build trust.

Here is what marketplace payment systems cost to build:

• Basic marketplace payments (4 to 6 weeks, $20K to $40K): Stripe Connect Express integration, seller onboarding, single commission model, basic refund handling, and payout dashboard. Suitable for MVP marketplaces with straightforward payment flows.
• Full marketplace payment system (8 to 12 weeks, $40K to $80K): Everything above plus multi-seller carts, escrow/delayed payouts, dispute management, seller analytics dashboard, variable commission tiers, and dunning for failed payouts.
• Enterprise marketplace payments (12 to 20 weeks, $80K to $150K): Multi-currency support, instant payouts, subscription-based seller plans, advanced reporting and reconciliation, tax compliance across jurisdictions, and integration with accounting systems.

Ongoing Costs

Stripe processing: 2.9% plus $0.30 per transaction. Stripe Connect fee: 0.25% per payout to connected accounts (on Express/Custom). On $500K in monthly GMV with a 15% take rate, your Stripe costs are roughly $15K to $18K/month. Your revenue from commissions: $75K/month. The math works.

We build marketplace payment systems for platforms across industries. Book a free strategy call to discuss your marketplace payment architecture.