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

# 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

<CardGroup cols={2}>
  <Card title="Outgoing Transfers" icon="arrow-up-right">
    Send money to beneficiaries:

    * Vendor payments
    * Customer refunds
    * Payroll disbursements
    * Business expenses
  </Card>

  <Card title="Internal Transfers" icon="arrows-rotate">
    Move funds between accounts:

    * Currency conversions
    * Balance management
    * Account consolidation
    * Settlement transfers
  </Card>
</CardGroup>

## Supported Payment Methods

<AccordionGroup>
  <Accordion title="Bank Account Transfers" icon="building-columns">
    **Features**

    * Direct bank deposits
    * Real-time transfers (where available)
    * Automated account validation

    **Supported Regions**

    * Nigeria (NGN transfers)
    * Canada (Interac)

    **Processing Times**

    * NGN transfers:Almost Immediate
    * Interac (Canada): Almost Immediate

    **Transaction Limits**

    * NGN: ₦100 - ₦99,900,000 per transaction
    * CAD Interac: C5-C25,000 per transaction
  </Accordion>

  <Accordion title="Stablecoin Transfers" icon="coins">
    **Supported Tokens & Networks**

    * USDT: Ethereum (ETH), Tron (TRX), BNB Smart Chain (BSC)
    * USDC: Ethereum (ETH), Polygon (MATIC), Avalanche (AVAXC)

    **Features**

    * Multi-chain support
    * Low transaction fees
    * Fast settlement times
    * Cross-border capability

    **Processing Times**

    * TRX Network: 1-3 minutes (6 confirmations)
    * ETH Network: 5-30 minutes (12 confirmations)
    * MATIC Network: 1-5 minutes (15 confirmations)
    * AVAXC Network: 1-5 minutes (15 confirmations)

    **Transaction Limits**

    * Minimum: 10 USDT/USDC
    * Maximum: 100,000 USDT/USDC per transaction
    * Daily Limit: 500,000 USDT/USDC

    **Network Fees**

    * TRX: \~1 USDT
    * ETH: Variable (gas fees)
    * MATIC: \~0.1 USDC
    * AVAXC: \~0.1 USDC
  </Accordion>

  <Accordion title="Interac e-Transfer" icon="money-bill-transfer">
    **Features**

    * Email money transfers
    * Real-time notifications
    * Automated deposits
    * Canadian bank support

    **Requirements**

    * Canadian bank account
    * Valid email/phone
    * Account verification

    **Processing Times**

    * Standard Transfer: 15-30 minutes
    * Auto-deposit: 5-15 minutes
    * After-hours: Next business day
    * Failed transfer reversals: 3-5 business days

    **Transaction Limits**

    * Minimum: C\$100
    * Maximum: C\$10,000 per transaction
    * Daily Limit: C\$20,000
    * 7-day Limit: C\$70,000
  </Accordion>
</AccordionGroup>

## Currency Support & Exchange

<CardGroup cols={3}>
  <Card title="NGN" icon="naira-sign">
    * Local bank transfers
    * Real-time payments
    * Account validation
    * Daily Limit: ₦100,000,000
  </Card>

  <Card title="CAD" icon="canadian-dollar-sign">
    * Interac e-Transfer
    * EFT payments
    * Wire transfers
    * Daily Limit: C\$100,000
  </Card>
</CardGroup>

## Key Concepts

### Beneficiaries

<Info>
  A beneficiary represents a recipient of funds. They can be:

  * Bank account holders
  * Crypto wallet addresses
  * Interac recipients

  Each beneficiary type requires specific validation:

  * Crypto addresses: Chain and address format validation
  * Interac: Email registration verification
</Info>

### Transfer Flow

<Steps>
  <Step title="Create Beneficiary">
    Add and validate recipient details

    * Verify account/address information
    * Validate against destination requirements
    * Store beneficiary ID for future use
  </Step>

  <Step title="Initiate Transfer">
    Specify amount, currency, and purpose

    * Check against transfer limits
    * Verify sufficient balance
    * Include required reference information
  </Step>

  <Step title="Authentication">
    Complete any required verification

    * 2FA if enabled
    * Transfer PIN validation
    * Additional security checks
  </Step>

  <Step title="Processing">
    Monitor transfer status via webhooks

    * Track transfer progress
    * Handle notifications
    * Process confirmations
  </Step>
</Steps>

### Transfer Status Lifecycle

<Note>
  Transfers progress through these states:

  1. `created` - Transfer initiated and validated
  2. `processing` - Funds being transferred
  3. `successful` - Confirmed and completed
  4. `failed` - Transfer unsuccessful
  5. `cancelled` - Manually or automatically cancelled

  Each status change triggers a webhook notification to your registered endpoint.
</Note>

## Best Practices

1. **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
2. **Error Handling**
   * Implement proper retry logic
   * Monitor transfer status
   * Handle timeout scenarios
   * Log all transfer attempts
   * Process webhook notifications
3. **Security & Compliance**
   * Implement proper authentication
   * Validate webhook signatures
   * Monitor for suspicious patterns
   * Follow regulatory requirements
   * Maintain audit trails
4. **Rate Management**
   * Cache exchange rates appropriately
   * Handle rate expiration
   * Implement rate refresh logic
   * Show clear rate information

<Card title="Get Started">
  Learn more about:

  * [Creating Beneficiaries](/transfers/beneficiaries/create-beneficiary)
  * [Initiating Transfers](/transfers/transfers/initiate-bank-transfer)
  * [Listing Transfers](/transfers/transfers/list-transfers)
  * [Error Handling](/errors)
</Card>