> ## Documentation Index
> Fetch the complete documentation index at: https://docs.juicyway.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CardGroup cols={2}>
  <Card title="Bank Accounts" icon="building-columns">
    **Features**

    * Multiple currency support
    * Account validation
    * Local & international transfers
    * Automated verification
  </Card>

  <Card title="Crypto Addresses" icon="wallet">
    **Features**

    * Multiple chain support
    * Address validation
    * Network detection
    * Chain verification
  </Card>

  <Card title="Interac Recipients" icon="money-bill-transfer">
    **Features**

    * Email/phone association
    * Auto-deposit support
    * Canadian accounts only
    * Real-time validation
  </Card>

  <Card title="Mobile Money" icon="mobile-screen">
    **Coming Soon**

    * Multiple providers
    * Number validation
    * Regional support
    * Instant verification
  </Card>
</CardGroup>

## Beneficiary Information

### Bank Account Beneficiaries

<ResponseField name="account_details" type="object" required>
  <Expandable title="Required Fields">
    <ResponseField name="account_number" type="string" required>
      Bank account number
    </ResponseField>

    <ResponseField name="account_name" type="string" required>
      Account holder name
    </ResponseField>

    <ResponseField name="bank_code" type="string" required>
      Bank routing/sort code
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      Account currency (e.g., NGN, USD, CAD)
    </ResponseField>
  </Expandable>
</ResponseField>

### Crypto Address Beneficiaries

<ResponseField name="crypto_details" type="object" required>
  <Expandable title="Required Fields">
    <ResponseField name="address" type="string" required>
      Wallet address
    </ResponseField>

    <ResponseField name="chain" type="string" required>
      Blockchain network (ETH, TRX, etc.)
    </ResponseField>

    <ResponseField name="currency" type="string" required>
      Token currency (USDT, USDC)
    </ResponseField>
  </Expandable>
</ResponseField>

### Interac Recipients

<ResponseField name="interac_details" type="object" required>
  <Expandable title="Required Fields">
    <ResponseField name="email" type="string" required>
      Recipient email
    </ResponseField>

    <ResponseField name="name" type="object" required>
      <ResponseField name="first_name" type="string" required>
        First name
      </ResponseField>

      <ResponseField name="last_name" type="string" required>
        Last name
      </ResponseField>
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Optional phone number
    </ResponseField>
  </Expandable>
</ResponseField>

## Key Operations

<Steps>
  <Step title="Create Beneficiary">
    Add new transfer recipients with validated details. See [Create Beneficiary](/transfers/beneficiaries/create-beneficiary).
  </Step>

  <Step title="Retrieve Details">
    Fetch beneficiary information by ID. See [Fetch Beneficiary](/transfers/beneficiaries/fetch-beneficiary).
  </Step>

  <Step title="List Beneficiaries">
    Get a paginated list of all beneficiaries. See [List Beneficiaries](/transfers/beneficiaries/list-beneficiaries).
  </Step>
</Steps>

## Validation Rules

<AccordionGroup>
  <Accordion title="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
  </Accordion>

  <Accordion title="Crypto Address Validation">
    * Address must be valid for the specified chain
    * Chain must support the selected token
    * Address checksum verification
    * Network compatibility check
  </Accordion>

  <Accordion title="Interac Validation">
    * Valid Canadian email format
    * Registered for Interac e-Transfer
    * Optional phone number in Canadian format
    * Name matching verification
  </Accordion>
</AccordionGroup>

## 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

<Card title="Next Steps">
  Learn how to:

  * [Create Beneficiaries](/transfers/beneficiaries/create-beneficiary)
  * [Fetch Beneficiary Details](/transfers/beneficiaries/fetch-beneficiary)
  * [List All Beneficiaries](/transfers/beneficiaries/list-beneficiaries)
</Card>