Beneficiaries

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

account_details

object

required

Show Required Fields

account_number

string

required

Bank account number

account_name

string

required

Account holder name

bank_code

string

required

Bank routing/sort code

currency

string

required

Account currency (e.g., NGN, USD, CAD)

Crypto Address Beneficiaries

crypto_details

object

required

Show Required Fields

address

string

required

Wallet address

chain

string

required

Blockchain network (ETH, TRX, etc.)

currency

string

required

Token currency (USDT, USDC)

Interac Recipients

interac_details

object

required

Show Required Fields

string

required

Recipient email

name

object

required

first_name

string

required

First name

last_name

string

required

Last name

phone_number

string

Optional phone number

Key Operations

Create Beneficiary

Add new transfer recipients with validated details. See Create Beneficiary.

Retrieve Details

Fetch beneficiary information by ID. See Fetch Beneficiary.

List Beneficiaries

Get a paginated list of all beneficiaries. See List Beneficiaries.

Validation Rules

Bank Account Validation

Crypto Address Validation

Interac Validation

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

Next Steps

Learn how to:

On this page

Overview
Supported Beneficiary Types
Beneficiary Information
Bank Account Beneficiaries
Crypto Address Beneficiaries
Interac Recipients
Key Operations
Validation Rules
Best Practices

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

account_details

object

required

Show Required Fields

account_number

string

required

Bank account number

account_name

string

required

Account holder name

bank_code

string

required

Bank routing/sort code

currency

string

required

Account currency (e.g., NGN, USD, CAD)

Crypto Address Beneficiaries

crypto_details

object

required

Show Required Fields

address

string

required

Wallet address

chain

string

required

Blockchain network (ETH, TRX, etc.)

currency

string

required

Token currency (USDT, USDC)

Interac Recipients

interac_details

object

required

Show Required Fields

string

required

Recipient email

name

object

required

first_name

string

required

First name

last_name

string

required

Last name

phone_number

string

Optional phone number

Key Operations

Create Beneficiary

Add new transfer recipients with validated details. See Create Beneficiary.

Retrieve Details

Fetch beneficiary information by ID. See Fetch Beneficiary.

List Beneficiaries

Get a paginated list of all beneficiaries. See List Beneficiaries.

Validation Rules

Bank Account Validation

Crypto Address Validation

Interac Validation

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

Next Steps

Learn how to:

On this page

Overview
Supported Beneficiary Types
Beneficiary Information
Bank Account Beneficiaries
Crypto Address Beneficiaries
Interac Recipients
Key Operations
Validation Rules
Best Practices

Overview

Supported Beneficiary Types

Bank Accounts

Crypto Addresses

Interac Recipients

Mobile Money

Beneficiary Information

Bank Account Beneficiaries

Crypto Address Beneficiaries

Interac Recipients

Key Operations

Validation Rules

Best Practices

Next Steps

exchange

payouts

payments

Beneficiaries

Overview

Supported Beneficiary Types

Bank Accounts

Crypto Addresses

Interac Recipients

Mobile Money

Beneficiary Information

Bank Account Beneficiaries

Crypto Address Beneficiaries

Interac Recipients

Key Operations

Validation Rules

Best Practices

Next Steps

​Overview

​Supported Beneficiary Types

Bank Accounts

Crypto Addresses

Interac Recipients

Mobile Money

​Beneficiary Information

​Bank Account Beneficiaries

​Crypto Address Beneficiaries

​Interac Recipients

​Key Operations

​Validation Rules

​Best Practices

Next Steps

exchange

payouts

payments

​Overview

​Supported Beneficiary Types

Bank Accounts

Crypto Addresses

Interac Recipients

Mobile Money

​Beneficiary Information

​Bank Account Beneficiaries

​Crypto Address Beneficiaries

​Interac Recipients

​Key Operations

​Validation Rules

​Best Practices

Next Steps

Overview

Supported Beneficiary Types

Beneficiary Information

Bank Account Beneficiaries

Crypto Address Beneficiaries

Interac Recipients

Key Operations

Validation Rules

Best Practices

Overview

Supported Beneficiary Types

Beneficiary Information

Bank Account Beneficiaries

Crypto Address Beneficiaries

Interac Recipients

Key Operations

Validation Rules

Best Practices