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

# Account Management

> Configure company bank accounts and crypto wallets that source and receive funds during Fundflow ramp requests.

## Overview

Fundflow requires you to set up both **bank accounts** and **crypto wallets** to facilitate on-ramp and off-ramp transactions:

<CardGroup cols={2}>
  <Card title="Bank Accounts" icon="building-columns">
    For fiat currency transactions (EUR, USD, GBP)
  </Card>

  <Card title="Crypto Wallets" icon="wallet">
    For cryptocurrency transactions across multiple blockchains
  </Card>
</CardGroup>

**Both account types are required:**

* **On-Ramp** (Fiat → Crypto): Bank account → Crypto wallet
* **Off-Ramp** (Crypto → Fiat): Crypto wallet → Bank account

***

## Bank Accounts

### Supported Bank Account Types

Fundflow supports multiple payment networks across different regions:

| Type             | Region         | Description                | Required Fields                            |
| ---------------- | -------------- | -------------------------- | ------------------------------------------ |
| **EUR\_SEPA**    | Europe         | SEPA transfers             | IBAN, BIC                                  |
| **USD\_WIRE**    | United States  | Wire transfers             | Account number, Routing number             |
| **USD\_ACH**     | United States  | ACH transfers              | Account number, Routing number             |
| **USD\_SWIFT**   | United States  | SWIFT transfers            | BIC, Account number, Bank address          |
| **GBP\_FPS**     | United Kingdom | Faster Payments            | Account number, Sort code                  |
| **GBP\_CHAPS**   | United Kingdom | CHAPS transfers            | Account number, Sort code                  |
| **OTHER\_SWIFT** | International  | Other currencies via SWIFT | Currency code, BIC, IBAN or Account number |

### Adding a Bank Account

<Steps>
  <Step title="Create Bank Account">
    Use the [Create Company Bank Account](/api-reference/Fundflow-API/company-bank-accounts/create-a-company-bank-account) endpoint

    Provide required information based on account type:

    * Account holder details (company name, address)
    * Bank details (name, country, account numbers)
    * Contact information (email, phone)
    * Supported ramp type (ON\_RAMP, OFF\_RAMP, or both)
  </Step>

  <Step title="Verification Process">
    Your bank account will be created with **PENDING** verification status

    The Venly team will manually review and verify the account details
  </Step>

  <Step title="Account Verified">
    Once verified, the status changes to **VERIFIED** and the account can be used for transactions
  </Step>
</Steps>

<Note>
  Bank account verification is done manually to ensure security and compliance with financial regulations.
</Note>

### Bank Account Requirements

* Account must be in your company's legal name
* Valid account numbers in the correct format for the account type
* Bank must be in a supported country
* Complete and accurate beneficiary address information

### Managing Bank Accounts

**List all bank accounts:**

```bash theme={null}
GET /v1/company-bank-accounts
```

**Get specific account:**

```bash theme={null}
GET /v1/company-bank-accounts/{id}
```

**Update account name:**

```bash theme={null}
PATCH /v1/company-bank-accounts/{id}
```

<Warning>
  Updates use optimistic locking. Include the current `version` number to prevent concurrent modification conflicts.
</Warning>

***

## Crypto Wallets

### Supported Blockchain Networks

Fundflow supports wallets on the following blockchain networks:

* **Ethereum** (ETH, USDC, EURC, USDS)
* **Polygon** (POL)
* **Base**
* **Arbitrum**
* **Sui**

### Adding a Crypto Wallet

<Steps>
  <Step title="Create Wallet">
    Use the [Create Company Wallet](/api-reference/Fundflow-API/company-wallets/create-a-company-wallet) endpoint

    Provide:

    * Wallet address (e.g., 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb)
    * Blockchain network (ETHEREUM, POLYGON, BASE, ARBITRUM, or SUI)
    * Optional description for identification
  </Step>

  <Step title="Verification Process">
    Your wallet will be created with **PENDING** verification status

    Complete the verification process to prove wallet ownership
  </Step>

  <Step title="Wallet Verified">
    Once verified, the status changes to **VERIFIED** and the wallet can be used for on-ramp transactions
  </Step>
</Steps>

### Managing Crypto Wallets

**List all wallets:**

```bash theme={null}
GET /v1/company-wallets
```

Filter by:

* Verification status (PENDING, VERIFIED, DENIED)
* Blockchain network
* Wallet address

**Get specific wallet:**

```bash theme={null}
GET /v1/company-wallets/{id}
```

**Update wallet description:**

```bash theme={null}
PATCH /v1/company-wallets/{id}
```

***

## Account Statuses

| Status       | Meaning               | Actions Available            |
| ------------ | --------------------- | ---------------------------- |
| **PENDING**  | Awaiting verification | Wait for review              |
| **VERIFIED** | Ready to use          | Can be used in ramp requests |
| **DENIED**   | Verification failed   | Review details and resubmit  |

***

## Supported Ramp Types

When creating a bank account, specify which operations it supports:

* **ON\_RAMP**: Can receive fiat deposits (for buying crypto)
* **OFF\_RAMP**: Can send fiat withdrawals (for selling crypto)
* **ON\_AND\_OFF\_RAMP**: Supports both operations

<Tip>
  Use descriptive names for your accounts like "EUR SEPA - Operations" or "Main Treasury Wallet" to easily identify them when creating ramp requests.
</Tip>

***

## API Reference

<CardGroup cols={2}>
  <Card title="Bank Accounts API" icon="building-columns" href="/api-reference/Fundflow-API/company-bank-accounts/list-company-bank-accounts">
    Manage company bank accounts
  </Card>

  <Card title="Wallets API" icon="wallet" href="/api-reference/Fundflow-API/company-wallets/list-company-wallets">
    Manage company crypto wallets
  </Card>

  <Card title="Supported Currencies" icon="coins" href="/api-reference/Fundflow-API/fiat-currencies/list-all-fiat-currencies">
    View supported fiat currencies
  </Card>

  <Card title="Supported Crypto" icon="bitcoin-sign" href="/api-reference/Fundflow-API/crypto-currencies/list-all-crypto-currencies">
    View supported cryptocurrencies
  </Card>
</CardGroup>

***

## Best Practices

<Tip>
  **Prepare Accounts Early**: Add and verify your bank accounts and wallets during your company onboarding process, before you need to create ramp requests.
</Tip>

<Tip>
  **Multiple Accounts**: You can add multiple bank accounts and wallets to support different currencies and use cases.
</Tip>

<Warning>
  **Security**: Never share private keys or seed phrases. Fundflow only needs your wallet address for verification.
</Warning>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Create Ramp Requests" icon="arrow-right-arrow-left" href="/guides/payments/transactions">
    Start creating on-ramp and off-ramp transactions
  </Card>

  <Card title="Fee Structure" icon="percent" href="/guides/payments/fees">
    Understand fee calculations
  </Card>
</CardGroup>