Implement a Stripe Connect platform payout with dynamic descriptor routing and cross-account balance transfer with fee withholding

domain: payment-rails/Stripe · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a Stripe Connect platform charge using the destination charge model: charge the customer on the platform account and specify the destination connected account ID and the transfer_amount (net of your platform fee)
  2. Set the statement_descriptor_suffix on the charge to a connected account-specific value so the cardholder sees the merchant's name on their bank statement rather than the platform name
  3. Calculate the application fee as the difference between the total charge amount and the transfer_amount; the application fee is withheld automatically on destination charges — do not create a separate transfer for the fee
  4. For payouts to connected accounts with manual payout schedules, trigger the payout explicitly via the Stripe API using the connected account's Stripe-Account header and specify the amount, currency, and payout method (bank_account or card)
  5. Monitor the payout status via webhooks: payout.paid confirms funds reached the bank; payout.failed contains a failure_code (e.g., no_account, insufficient_funds) requiring you to notify the connected account and resolve the issue before re-attempting
  6. Reconcile platform application fees by listing application fee objects and matching them to your internal commission records; use the created timestamp range filter to pull fees for a specific settlement period

Known gotchas

Related routes

Manage cross-border payouts for Stripe Connect connected accounts including recipient requirements and currency considerations
docs.stripe.com · 6 steps · unrated
Design a multi-rail payout routing strategy to optimize speed, cost, and reach for global marketplace disbursements
stripe.com · 6 steps · unrated
Create a Stripe payout to a connected account's external bank account and initiate instant payouts
stripe.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans