Payouts Overview - BoomFi

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

Prerequisites

Funded Virtual Accounts
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)

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.

BoomFi account payouts

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.

⌘I