Bulk Transfers Overview
Execute multiple transfers efficiently in a single batch operation
Overview
Bulk transfers allow you to process multiple payments efficiently by grouping them into a single batch operation. This feature is ideal for handling payroll, mass payouts, or any scenario requiring multiple transfers to be processed together.
Before initiating bulk transfers:
- Ensure sufficient balance for all transfers
- Verify all beneficiary details
- Check transfer limits for your account tier
Key Features
Batch Processing
- Process up to 1,000 transfers per batch
- Single API call for multiple transfers
- Automatic validation of all entries
- Bulk status tracking
Error Handling
- Individual transfer validation
- Partial batch processing
- Failed transfer retries
- Detailed error reporting
Status Tracking
- Real-time batch status updates
- Individual transfer tracking
- Webhook notifications
- Comprehensive reporting
Security Features
- Transfer PIN protection
- Multi-factor authentication
- Fraud detection
- Rate limiting
Supported Transfer Types
Batch Lifecycle
1
Creation
Initialize batch with basic details:
- Batch reference
- Description
- Expiration time
2
Adding Transfers
Add transfers to the batch:
- Beneficiary details
- Transfer amounts
- Payment references
- Optional metadata
3
Validation
System validates:
- Beneficiary information
- Transfer limits
- Available balance
- Currency support
4
Execution
Process the batch:
- PIN authorization
- Transfer initiation
- Status tracking
- Webhook notifications
5
Completion
Final status updates:
- Success counts
- Failed transfers
- Retry options
- Detailed reporting
Status Definitions
Status | Description |
---|---|
created | Batch initialized but not executed |
executing | Transfers being processed |
completed | All transfers processed |
cancelled | Batch cancelled before execution |
expired | Batch expired without execution |
Transaction Limits
Batch Limits
- Maximum transfers per batch: 1,000
- Minimum transfers per batch: 2
- Batch expiration: 24 hours from creation
- Maximum retries per transfer: 3
Amount Limits
- Based on transfer type and currency
- Subject to account tier limits
- Daily and monthly caps apply
Processing Times
Processing times vary by transfer type:
- NGN transfers: 5-15 minutes
- USD/International: 1-3 business days
- Crypto transfers: Network-dependent
- Interac e-Transfer: 15-30 minutes
Best Practices
-
Batch Organization
- Group similar transfers together
- Use consistent currencies when possible
- Include clear references
- Set appropriate expiration times
-
Error Handling
- Implement webhook monitoring
- Handle partial successes
- Retry failed transfers
- Log all status changes
-
Security
- Validate all beneficiary details
- Use unique references
- Monitor for suspicious patterns
- Implement proper access controls
-
Performance
- Optimize batch sizes
- Schedule large batches appropriately
- Monitor processing times
- Track success rates