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

# Payouts Overview

> Send crypto from your virtual account to an external wallet.

Payouts move funds from your BoomFi virtual account balance to an external crypto wallet.

## Prerequisites

* Funded [Virtual Accounts](/settlement/virtual-accounts)
* [Authentication](/authentication) (`X-API-KEY`, `X-API-Nonce`, `X-API-Signature`)
* Appropriate permissions; session-based dashboard auth may require **step-up** (`X-Step-Up-Token`) for payouts

## Create a payout (API)

```bash theme={null}
curl -X POST "https://mapi.boomfi.xyz/v1/accounts/virtual/payout/address" \
  -H "X-API-KEY: sk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "X-API-Nonce: nonce-unique-1" \
  -H "X-API-Signature: <hmac-hex>" \
  -d '{
    "address": "0xRecipientWallet…",
    "chain_id": 8453,
    "currency": "USDC",
    "amount": "10.00"
  }'
```

Use the request schema from the API reference (`CreatePayoutToWalletAddressRequest`) for exact fields.

## Dashboard

Use the Account experience (`https://app.boomfi.xyz/dashboard/account`) for payout controls in the merchant UI.

<img src="https://mintcdn.com/boom-fi/3iSUMnxX80iQMgo0/payouts/images/account-payout-boomfi.png?fit=max&auto=format&n=3iSUMnxX80iQMgo0&q=85&s=e469c4eac15ddded0577d3c63756293a" alt="BoomFi account payouts" width="1440" height="900" data-path="payouts/images/account-payout-boomfi.png" />

## Events and monitoring

Track resulting payments/transactions in the dashboard and via webhooks. Failed webhook delivery does not reverse an on-chain payout: reconcile carefully.