Payouts overview

Use the Payouts API when a business cashes out its payment processor balance to a bank account (standard) or debit card (instant).

​

What you do first

1. Check business balance.
2. Calculate barber fees before cash-out when you need the fee line.
3. Create an instant payout (or your standard payout path) with an idempotency key.
4. Send the payout to a financial account or debit card already on the business.

Instant payouts usually land in minutes, with higher fees and daily limits. Standard payouts take 1-3 business days and cost less.

​

States that matter

​

When a call fails

Common failures: not enough balance, a bad destination, a hit daily limit, a frequency Guile does not schedule, or a restricted account. The problem document names the cause and whether a retry is safe. If the outcome is unknown after a timeout, retry with the same idempotency key so Guile can replay the first result.

​

Related paths

• Fee quotes live under Fees.
• Business money settings live under Businesses.
• Idempotency keys: required on payout writes
• Problem types: recover from a failed call