Skip to main content
The Payouts API enables businesses to transfer funds from their payment processor balance to their bank accounts or cards. The platform supports both instant payouts for immediate access and standard payouts for lower-cost transfers.

​
Creating Payouts

All payout operations require an idempotency key to prevent duplicate transactions. When you create an instant payout, the system validates your available balance, calculates applicable fees, and processes the transfer. Instant payouts typically arrive within minutes but come with higher fees and daily limits. Standard payouts take 1-3 business days but cost less and support larger amounts.

​
Fee Calculation

Before creating a payout, you should calculate the barber fees to understand the total cost. Fees vary based on the payout method, destination type, and transaction amount. The fee calculation API helps you provide transparent pricing to your users.

​
Payout Destinations

You can send payouts to any financial account or card you’ve added to your business. The platform automatically determines the appropriate transfer method based on your destination choice and payout type. Bank accounts receive funds via ACH transfer, while cards receive instant credits. Each destination type has different processing times, fees, and limits.

​
Error Handling

Common payout failures include insufficient funds, invalid destination accounts, exceeded limits, or restricted accounts. The API provides specific error codes to help you handle each scenario appropriately. When a payout fails, you can safely retry using the same idempotency key without creating duplicate transactions.

​
Best Practices

Always use idempotency keys to prevent duplicate payouts, especially in retry scenarios. Check your business balance before creating payouts to ensure sufficient funds. Calculate and disclose fees upfront so users understand the total cost. Monitor your daily payout limits and plan larger transfers accordingly. The platform tracks these limits automatically and will reject payouts that exceed them.