Introduction

Paying vendors is the part of running a marketplace that nobody talks about until it breaks. When you have 10 vendors, manual bank transfers are annoying. When you have 50, they're a full-time job. When you have 200, they're unsustainable.

PuppetVendors integrates directly with Stripe Connect to handle vendor payouts natively. This is not a Zapier workaround or a CSV export you upload somewhere else. Stripe is built into PuppetVendors as a core payout method alongside PayPal. You connect your Stripe account, your vendors complete their onboarding through the vendor portal, and payouts flow directly to their bank accounts or cards.

The integration handles commission calculations, payout scheduling, refund offsets, and vendor onboarding all within PuppetVendors. Your vendors never need to log into Stripe. You never need to leave the PuppetVendors dashboard to process payments.

How It Works

PuppetVendors uses Stripe Connect to manage the relationship between your marketplace and your vendors. Here is the structure:

Your account (the merchant): You hold a Standard Stripe account. This is your main business Stripe account where you manage your platform settings, branding, and payout controls.

Your vendors' accounts: Each vendor gets a Stripe Connect Express account. When a vendor joins your marketplace and you activate Stripe payouts, PuppetVendors prompts them to complete Stripe onboarding directly from the vendor portal. They enter their banking details, verify their identity, and accept Stripe's terms. PuppetVendors never see or store any of their financial information. Stripe handles all of that.

The payout flow:

1. A customer places an order on your Shopify store.

2. PuppetVendors automatically calculates the vendor's share based on your commission rules (set at the shop, vendor, product, or SKU level).

3. When you process payouts, PuppetVendors sends the correct amount to each vendor's connected Stripe Express account.

4. Stripe deposits the funds into the vendor's bank account via ACH transfer or to their card.

Refund handling: If a customer returns an item or requests a refund after a payout has been processed, PuppetVendors automatically offsets the refunded amount in the next payout cycle. You do not need to manually chase vendors for refund clawbacks or adjust spreadsheets. The system handles the deduction automatically.

What Makes This Different from Other Marketplace Apps

Most Shopify multi-vendor apps treat payouts as an afterthought. They calculate commissions and then expect you to figure out how to actually move the money. That usually means exporting a CSV, logging into your bank, and making dozens of individual transfers every payout cycle.

PuppetVendors treats payouts as a core feature, not an add-on. The Stripe integration means money moves from your account to your vendors' bank accounts without leaving the PuppetVendors dashboard. The entire workflow - commission calculation, payout creation, fund transfer, and record keeping - happens in one place.

Key capabilities:

Direct bank transfers (ACH). Funds go straight to your vendors' bank accounts. No intermediary platforms, no payment links, no manual transfers.

Card payouts. Vendors can also receive payouts to their debit cards through Stripe, which is useful for vendors who prefer faster access to funds.

Automated payout scheduling. Set a monthly payout date (the 14th is recommended to allow buffer time for returns and refunds) and PuppetVendors processes all vendor payouts automatically on that date.

Commission-aware payouts. PuppetVendors calculates the correct split before sending money. Whether you charge 15% across the board, 20% for one vendor and 10% for another, or different rates per product - the math is done before funds move.

Automatic refund offsets. Refunds from previous cycles are deducted from the next payout automatically. No manual reconciliation required.

Vendor self-service onboarding. Vendors complete their Stripe setup through the vendor portal. They add their bank details, verify their identity, and accept terms without you needing to collect or handle any sensitive financial information.

Complete payout history. Every payout is logged with the vendor name, amount, commission split, date, and status. Exportable for your records and visible to vendors in their portal.

How Different Businesses Use This

Multi-vendor marketplace operators running 50+ vendors save the most time. Instead of spending hours every payout cycle exporting commission data, calculating splits, and making individual bank transfers, the entire process runs through PuppetVendors and Stripe. At scale, this is the difference between needing a dedicated finance person for payouts and not needing one at all.

Consignment store owners use Stripe payouts to pay consignors their share after items sell. Each consignor has their own commission rate in PuppetVendors, and the correct split flows through to Stripe automatically. Consignors can see their earnings and payout status in the vendor portal, which eliminates "where's my money?" conversations. For stores managing 30+ consignors, this replaces hours of spreadsheet work every month. Learn how to automate vendor payouts.

Online art galleries often have unique commission arrangements with each artist. One artist might be on a 60/40 split, another on 70/30, and a featured artist on 50/50 for a specific collection. PuppetVendors manages all of these per-vendor commission rules, and the Stripe integration ensures each artist receives exactly the right amount without manual calculation.

Print-on-demand businesses can automate designer royalty payments. Each sale generates a commission record in PuppetVendors based on the designer's agreed rate, and royalties are paid out through Stripe on your schedule. Designers see their earnings in real time through the vendor portal.

How to Set Up

Step 1: Create or log into your Stripe account If you do not have a Stripe account, create one at stripe.com. If you already have one, log in and make sure you are not in Test mode.

Step 2: Activate Stripe Connect In your Stripe dashboard, navigate to Connect and click "Get started." This enables the platform features that allow you to create connected accounts for your vendors.

Step 3: Complete your brand settings Stripe requires a business name, icon, and brand color for Connect onboarding. This is what your vendors will see when they set up their accounts. Complete this before connecting to PuppetVendors.

Step 4: Get your Stripe API key In your Stripe dashboard, go to Developers, then API Keys. Copy your live secret key (it starts with sk_live_). Do not use a test key for production payouts.

Step 5: Connect Stripe to PuppetVendors In your PuppetVendors merchant portal, go to Settings, then Payouts, then choose Stripe. Paste your API key and click "Test Connection" to confirm the setup.

Step 6: Fund your Stripe balance Before processing payouts, make sure your Stripe balance has sufficient funds. You can add funds through the Balance section in your Stripe dashboard. If you are in the US, allow at least 7 days for initial verification before your first payout date.

Step 7: Invite vendors to complete onboarding Once Stripe is connected, vendors are automatically prompted to complete their Stripe Express account setup through the vendor portal. They will add their bank account, verify their identity, and accept Stripe's terms. You can also send them an email prompt with instructions.

Step 8: Set your payout schedule Choose your monthly payout date in PuppetVendors. The 14th of each month is recommended because it provides enough buffer time to account for returns and refunds so you do not overpay your vendors.

Stripe Payout Fees

PuppetVendors does not charge any fees on top of Stripe's pricing. The fees you pay are Stripe's standard Connect pricing, which varies by country and transaction type.

For domestic ACH payouts in the US, Stripe charges $0.25 per payout. For cross-border transactions, additional fees apply based on the destination country. Visit stripe.com/connect/pricing for the exact rates in your region. The pricing page automatically loads your country-specific rates.

Setting a single monthly payout date (rather than paying vendors per order) keeps your Stripe fees low because you are processing one payout per vendor per month rather than dozens of individual transfers.

Common Troubleshooting

"Please complete your platform profile" This means your Stripe account brand settings are not finished. Go to your Stripe dashboard and complete the business name, icon, and brand color under Connect settings.

"Destination account needs capabilities enabled" This happens when a vendor has not completed their Stripe Express onboarding. Send them a reminder to finish the setup process through their vendor portal, including accepting Stripe's terms and conditions.

"Insufficient funds" Your Stripe balance does not have enough to cover the payouts. Top up your balance through the Stripe dashboard before retrying. You can retry failed payouts directly from PuppetVendors.

Payout marked as failed If a payout fails (due to incorrect bank details, closed accounts, etc.), PuppetVendors flags it in the payout dashboard. You can retry the payout after the vendor updates their banking information, or mark it as paid if you used an alternative payment method.

FAQ

Q: Which PuppetVendors plans include Stripe payouts? Stripe payouts are available on paid plans that include the payouts feature. Check the pricing page for details on which plans include direct Stripe integration.

Q: Is Stripe Connect available in my country? Stripe Connect is available in most countries, but not all. Canada is currently not supported for PuppetVendors Stripe payouts. Check Stripe's country availability page for the full list.

Q: Can I use both PayPal and Stripe for payouts? Yes. PuppetVendors supports both Learn how to aasdf and Stripe as payout methods. You can use whichever your vendors prefer, or offer both options. Some merchants use PayPal for vendors in regions where Stripe is not available and Stripe for everyone else.

Q: Does PuppetVendors store my vendors' banking information? No. PuppetVendors never stores any banking or card information. All sensitive financial data is handled and stored by Stripe. PuppetVendors only sends payout instructions to Stripe, which processes the actual money movement.

Q: What happens if a vendor does not complete their Stripe onboarding? Their payouts will not process until they complete the onboarding. PuppetVendors flags vendors with incomplete Stripe setup so you can follow up. You can also mark payouts as paid manually if you use an alternative payment method for those vendors.

Q: Can vendors see their payout history? Yes. Vendors can view their complete payout history, pending amounts, and commission details through the vendor portal. They do not need access to Stripe to see this information.

Q: How are refunds handled if a payout has already been processed? Refunds are automatically offset in the next payout cycle. If a customer returns an item after the vendor has been paid, PuppetVendors deducts the refunded amount from that vendor's next scheduled payout. No manual adjustment needed.

Q: Can I process payouts more frequently than monthly? The recommended schedule is monthly (on the 14th) to minimize Stripe fees and allow buffer time for refunds. However, you can process payouts manually at any time from the PuppetVendors dashboard if you need to pay vendors more frequently.

Q: What currency are payouts sent in? PuppetVendors supports multi-currency payouts through Stripe. The currency depends on your Stripe account settings and your vendors' locations. Make sure your Stripe account has multi-currency enabled if you pay vendors in different countries.