Transfers Overview
Initiate and manage fund transfers across multiple payment methods and currencies
Introduction
The Transfers API enables secure movement of funds between accounts using various payment methods. Whether you’re sending payments to vendors, paying out to customers, or managing internal transfers, our flexible API supports both domestic and international transactions.
Transfer Types
Outgoing Transfers
Send money to beneficiaries:
- Vendor payments
- Customer refunds
- Payroll disbursements
- Business expenses
Internal Transfers
Move funds between accounts:
- Currency conversions
- Balance management
- Account consolidation
- Settlement transfers
Supported Payment Methods
Currency Support & Exchange
NGN
- Local bank transfers
- Real-time payments
- Account validation
- Daily Limit: ₦100,000,000
USD
- ACH/Wire transfers
- Stablecoin settlements
- International payments
- Daily Limit: $500,000
CAD
- Interac e-Transfer
- EFT payments
- Wire transfers
- Daily Limit: C$100,000
Key Concepts
Beneficiaries
A beneficiary represents a recipient of funds. They can be:
- Bank account holders
- Crypto wallet addresses
- Binance Pay users
- Interac recipients
Each beneficiary type requires specific validation:
- Bank accounts: Account number and routing verification
- Crypto addresses: Chain and address format validation
- Interac: Email registration verification
Transfer Flow
Create Beneficiary
Add and validate recipient details
- Verify account/address information
- Validate against destination requirements
- Store beneficiary ID for future use
Initiate Transfer
Specify amount, currency, and purpose
- Check against transfer limits
- Verify sufficient balance
- Include required reference information
Authentication
Complete any required verification
- 2FA if enabled
- Transfer PIN validation
- Additional security checks
Processing
Monitor transfer status via webhooks
- Track transfer progress
- Handle notifications
- Process confirmations
Transfer Status Lifecycle
Transfers progress through these states:
created
- Transfer initiated and validatedprocessing
- Funds being transferredsuccessful
- Confirmed and completedfailed
- Transfer unsuccessfulcancelled
- Manually or automatically cancelled
Each status change triggers a webhook notification to your registered endpoint.
Best Practices
-
Pre-transfer Validation
- Verify beneficiary details before transfer
- Check sufficient balance availability
- Validate against all applicable limits
- Consider currency exchange rates
- Use test mode for integration
-
Error Handling
- Implement proper retry logic
- Monitor transfer status
- Handle timeout scenarios
- Log all transfer attempts
- Process webhook notifications
-
Security & Compliance
- Implement proper authentication
- Validate webhook signatures
- Monitor for suspicious patterns
- Follow regulatory requirements
- Maintain audit trails
-
Rate Management
- Cache exchange rates appropriately
- Handle rate expiration
- Implement rate refresh logic
- Show clear rate information
Get Started
Learn more about: