Create a new bulk transfer session for processing multiple transfers efficiently
Bulk transfers allow you to process multiple transfers in a single batch operation. This endpoint creates a new bulk transfer session that you can later populate with individual transfers and execute as a group.
Before initiating a bulk transfer:
Ensure sufficient balance for the expected total
Have your beneficiary details ready
Review the transfer limits and cut-off times
Maximum length: 200 characters
Used for reference and reporting
Timestamp when the bulk transfer session expires
Format: ISO 8601 (e.g., “2024-10-03T18:38:31Z”)
Maximum: 72 hours from creation
Default: 24 hours from creation
Your unique reference for this bulk transfer
Must be unique across all bulk transfers
Maximum length: 64 characters
Alphanumeric characters, hyphens, and underscores only
Additional data about the bulk transfer
Maximum size: 20KB
Key-value pairs of strings
Created bulk transfer session details
Reference Rules
Must be unique across all bulk transfers
Length: 1-64 characters
Allowed characters: A-Z, a-z, 0-9, -, _
Cannot start or end with hyphen/underscore
Expiration Rules
Must be in future
Minimum: 1 hour from creation
Maximum: 72 hours from creation
Must be valid ISO 8601 format
Description Rules
Maximum length: 200 characters
Cannot contain HTML or special characters
Optional but recommended for tracking
Metadata Rules
Maximum size: 20KB
Keys must be strings
Values must be strings
No nested objects allowed
10 bulk transfer initiations per minute
Maximum of 100 transfers per batch
Burst limit: 2 requests per second
Reference Generation
Use structured, meaningful references
Include date/time components
Add batch type identifiers
Store references for reconciliation
Error Handling
Implement proper retry logic
Monitor rate limits
Log all attempts
Handle timeouts gracefully
Session Management
Set reasonable expiration times
Plan for session timeouts
Monitor session status
Handle expired sessions
After creating a bulk transfer session:
Add transfers to the batch
Create a new bulk transfer session for processing multiple transfers efficiently
Bulk transfers allow you to process multiple transfers in a single batch operation. This endpoint creates a new bulk transfer session that you can later populate with individual transfers and execute as a group.
Before initiating a bulk transfer:
Ensure sufficient balance for the expected total
Have your beneficiary details ready
Review the transfer limits and cut-off times
Maximum length: 200 characters
Used for reference and reporting
Timestamp when the bulk transfer session expires
Format: ISO 8601 (e.g., “2024-10-03T18:38:31Z”)
Maximum: 72 hours from creation
Default: 24 hours from creation
Your unique reference for this bulk transfer
Must be unique across all bulk transfers
Maximum length: 64 characters
Alphanumeric characters, hyphens, and underscores only
Additional data about the bulk transfer
Maximum size: 20KB
Key-value pairs of strings
Created bulk transfer session details
Reference Rules
Must be unique across all bulk transfers
Length: 1-64 characters
Allowed characters: A-Z, a-z, 0-9, -, _
Cannot start or end with hyphen/underscore
Expiration Rules
Must be in future
Minimum: 1 hour from creation
Maximum: 72 hours from creation
Must be valid ISO 8601 format
Description Rules
Maximum length: 200 characters
Cannot contain HTML or special characters
Optional but recommended for tracking
Metadata Rules
Maximum size: 20KB
Keys must be strings
Values must be strings
No nested objects allowed
10 bulk transfer initiations per minute
Maximum of 100 transfers per batch
Burst limit: 2 requests per second
Reference Generation
Use structured, meaningful references
Include date/time components
Add batch type identifiers
Store references for reconciliation
Error Handling
Implement proper retry logic
Monitor rate limits
Log all attempts
Handle timeouts gracefully
Session Management
Set reasonable expiration times
Plan for session timeouts
Monitor session status
Handle expired sessions
After creating a bulk transfer session:
Add transfers to the batch