Manage instant and scheduled payouts for businesses on Guile
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.
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.
Before creating a payout, you should calculate the 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.
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.
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.
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.
