Airtm Bulk Payouts API
# Bulk Payouts Process multiple payouts efficiently in a single batch operation. Ideal for payroll, affiliate payments, or mass distributions. ## Overview Bulk payouts allow you to submit hundreds or thousands of payout instructions and process them as a coordinated batch, providing better performance and easier management than individual payouts. ## How It Works 1. **Prepare** your payout data with recipient emails and amounts 2. **Submit** the bulk payout request 3. **Validation** - System validates all payouts and checks balance 4. **Processing** - Individual payouts are processed in parallel 5. **Track** progress and handle any failures ## Validation Rules ### Amount Validation - Minimum amount: $0.01. If the recipient is a US resident, the minimum amount may be larger. - Maximum 2 decimal places allowed - Enterprise fee cannot equal or exceed payout amount (unless negative for bonuses) - Airtm fee cannot equal or exceed net amount (amount - enterprise fee) ### Data Validation - Email addresses must be valid format and correspond to active Airtm accounts - Notes field is required and cannot exceed 255 characters - No malicious patterns allowed in text fields (SQL injection protection) - URLs must be valid format when provided ### Batch Validation - No duplicate payouts within batch (based on email + amount + notes) - Total batch amount cannot exceed available account balance