​
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

​
Crypto Address Beneficiaries

​
crypto_details
object
required

​
Interac Recipients

​
interac_details
object
required

​
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

​
Best Practices

  1. Validation

    • Verify recipient details before creation
    • Test transfer with small amounts
    • Implement proper error handling
    • Monitor validation responses

  2. Security

    • Store beneficiary IDs, not details
    • Validate all input data
    • Implement access controls
    • Monitor for suspicious patterns

  3. Management

    • Regular beneficiary verification
    • Clean up unused beneficiaries
    • Track failed validations
    • Monitor success rates