Pays exactly what is owed to the creators of a treasury campaign by charging the billing owner's saved card, with no redirect.

How it works

1. Every payable creator who finished payout setup (or only participantIds, minus excludeParticipantIds) is held in settling.
2. The saved card (the default one, or paymentMethodId) is charged the total plus the fee (4% per creator, 50 cent minimum) while the payer is present.
3. Once the charge succeeds, each creator gets a transfer funded by it, and the batch ends paid or partially_failed.

A creator whose payouts were disabled before the payment landed is skipped and stays payable.

3D Secure

payment.status: requires_action means the bank asked the payer to confirm. Complete it with Stripe.js handleNextAction({ clientSecret }), then call POST /v1/payout-batches/{batchId}/confirm.

One left unfinished is cancelled after 30 minutes and every amount is payable again. Cancel it sooner with POST /v1/payout-batches/{batchId}/cancel.

Limits and errors

• 402 payment_required: no saved card. Nothing is held.
• 402 card_declined: the bank's reason; every amount is payable again.
• 402: card payouts are limited to $10,000.00 gross per rolling 30 days by default. Over it the call answers "Over your instant payout limit. Top up your balance to pay more this month, or contact support to raise the limit."
• 400: nothing payable ("Nothing is payable.").

Access and retries

Needs an owner, admin or billing admin, signed in or through a full-access key they created.

Send an Idempotency-Key so a retry never opens a second batch.