Skip to content
Tutorials Center
My learning

Topics

Lesson 28 of 38 ยท Connect and Marketplaces

Payouts, Balances and Transfers

Learn how Stripe balances work, the difference between transfers and payouts, pending versus available funds, payout schedules, negative balances and reconciliation with balance transactions.

Money on Stripe does not jump straight from a card to a bank account. It moves through balances, and each step has a name. Mixing up the words causes real confusion in marketplace code, so this lesson defines each one and then models the ledger so you can see how amounts change.

Vocabulary

  • Charge or PaymentIntent: the buyer pays. Funds enter a balance.
  • Balance: money Stripe holds for an account. It has a pending part (not yet released) and an available part (can be paid out or transferred).
  • Transfer: moves money from the platform's balance to a connected account's balance. It stays inside Stripe.
  • Payout: moves money from a Stripe balance to a real bank account or debit card.
  • Balance transaction: one line in the ledger explaining every change to a balance (charge, fee, refund, transfer, payout).
flowchart LR
  A["Buyer pays"] --> B["Pending balance"]
  B -->|"after settlement delay"| C["Available balance"]
  C -->|"Transfer"| D["Connected account balance"]
  D -->|"Payout"| E["Seller bank"]

Funds are first pending, then available, then paid out.

Pending and available

New funds are held as pending for a short period that depends on country, account history and industry (often a few days). Only available funds can be paid out. This is a protection against refunds and disputes. If you try to pay out more than is available, the API fails, so check the balance first.

Node.js A small balance model

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with node:readline or process.stdin), it gets the next line from this box.

Payout schedules

Each connected account has a payout schedule: daily, weekly, monthly or manual. Automatic schedules suit most sellers. Manual payouts let the platform decide when to release funds, for example after an order is delivered, and are a way to reduce risk when sellers could vanish with the money. For some account types the schedule is set by the platform, for others by the seller.

JavaScript
// Read-only: set a weekly payout schedule on a connected account
await stripe.accounts.update('acct_123', {
  settings: { payouts: { schedule: { interval: 'weekly', weekly_anchor: 'friday' } } },
});

// Read-only: a manual payout on the seller's balance
await stripe.payouts.create({ amount: 4000, currency: 'usd' }, { stripeAccount: 'acct_123' });

Negative balances

Refunds, disputes and reversed transfers can make a balance go negative. On a platform, the connected account normally owes that amount, but depending on the account type and your agreement, the platform may be liable if the seller cannot repay. Mitigate by delaying payouts until orders are fulfilled, keeping a reserve, and monitoring balances.

Node.js Holding payouts until delivery

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with node:readline or process.stdin), it gets the next line from this box.

Reconciliation with balance transactions

Accountants want every cent explained. Each balance transaction records amount, fee, net and a type (charge, refund, transfer, payout...). Summing nets between two payouts should equal the payout amount. Stripe can also produce reconciliation reports in the Dashboard. Store the Stripe ids (pi_, ch_, po_, txn_) next to your own order ids so you can trace any number.

Node.js Checking that a payout equals the sum of its parts

Press Run (or Ctrl + Enter) to see the result here.

Program input ยท what you'd type while the program runs

Type the answers before you press Run, one per line. Each time the program reads a line (with node:readline or process.stdin), it gets the next line from this box.

Compute and store amounts in integer cents everywhere, including reports. Convert to display currency only at the edge of the UI.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. What is a transfer in Stripe Connect?

    Transfers stay inside Stripe. Paying a bank account is a payout.
  2. 2. Which funds can be paid out?

    Pending funds must first become available after the settlement delay.
  3. 3. Why might a platform use manual payouts?

    Manual payouts give the platform control over timing and help manage risk.
  4. 4. What does a balance transaction represent?

    Each charge, fee, refund, transfer or payout appears as a balance transaction used for reconciliation.

Summary

  • Charges fill the pending balance, then funds become available.
  • Transfers move money between Stripe balances; payouts move it to a bank.
  • Payout schedules can be automatic or manual; manual control reduces risk.
  • Balance transactions explain every change and enable reconciliation.

Next: Test Mode and Test Cards