Beneficiaries
Beneficiaries
Manage and store transfer recipients for quick, secure payouts
Overview
Beneficiaries are pre-validated recipients for your transfers. Managing beneficiaries enables you to:
- Store recipient details securely
- Validate account information upfront
- Execute transfers quickly and safely
- Maintain an auditable recipient database
Supported Beneficiary Types
Bank Accounts
Features
- Multiple currency support
- Account validation
- Local & international transfers
- Automated verification
Crypto Addresses
Features
- Multiple chain support
- Address validation
- Network detection
- Chain verification
Interac Recipients
Features
- Email/phone association
- Auto-deposit support
- Canadian accounts only
- Real-time validation
Mobile Money
Coming Soon
- Multiple providers
- Number validation
- Regional support
- Instant verification
Beneficiary Information
Bank Account Beneficiaries
Crypto Address Beneficiaries
Interac Recipients
Key Operations
1
Create Beneficiary
Add new transfer recipients with validated details. See Create Beneficiary.
2
Retrieve Details
Fetch beneficiary information by ID. See Fetch Beneficiary.
3
List Beneficiaries
Get a paginated list of all beneficiaries. See List Beneficiaries.
Validation Rules
Bank Account Validation
Bank Account Validation
- Account numbers must be valid for the specified bank
- Account name must match bank records
- Bank code must be valid for the country
- Currency must be supported for the bank
Crypto Address Validation
Crypto Address Validation
- Address must be valid for the specified chain
- Chain must support the selected token
- Address checksum verification
- Network compatibility check
Interac Validation
Interac Validation
- Valid Canadian email format
- Registered for Interac e-Transfer
- Optional phone number in Canadian format
- Name matching verification
Best Practices
-
Validation
- Verify recipient details before creation
- Test transfer with small amounts
- Implement proper error handling
- Monitor validation responses
-
Security
- Store beneficiary IDs, not details
- Validate all input data
- Implement access controls
- Monitor for suspicious patterns
-
Management
- Regular beneficiary verification
- Clean up unused beneficiaries
- Track failed validations
- Monitor success rates