# Fund Transfer block

> Four-step fund transfer wizard with payee search, currency combobox, and balance checks

Money transfer flow over a 4-step Stepper: pick payee, set amount and funding source, review, authorize with a 6-digit code. Recent-payee grid, searchable saved accounts, multi-currency Combobox, low-balance Alert. ReUI Stepper plus shadcn Combobox.

- Type: Pro block
- Category: [Wizard](https://web.dev.reui.io/blocks/application/wizard.md)
- Page: https://web.dev.reui.io/blocks/application/wizard/wizard-7
- Docs (Base UI): https://web.dev.reui.io/docs/components/base/stepper.md
- Docs (Radix UI): https://web.dev.reui.io/docs/components/radix/stepper.md
- MCP: `get_block("wizard-7")`
- Built with: Alert, Avatar, Button, Checkbox, Combobox, Empty, Field, Icon Stack, Input, Item, Scroll Area, Select, Separator, Spinner, Stepper, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Payee tiles and a searchable account list, a currency picker with flags, a balance shortfall alert and a 6 digit code to authorize

## Agent notes

- `RECIPIENTS`, `PAYMENT_METHODS` and `CURRENCY_OPTIONS` are sample data; flags load from flagcdn.com through `CurrencyFlag`
- The pay step checks only that `securityCode` has 6 digits and `acceptedTerms` is ticked, then `handleSubmit` shows a `toast`; verify the code server side
- `handleChangePaymentMethod` always sets `paymentMethodId` to the debit card and shows a `toast`; it opens no picker

## When not to use

- One value picked from a long list inside an ordinary form: use [Combobox](https://web.dev.reui.io/components/combobox.md) (`get_component("combobox")`)
- Saving billing contacts and a spend limit, not sending money: use [Billing Setup](https://web.dev.reui.io/blocks/application/wizard/wizard-1.md) (`get_block("wizard-1")`)

## Third-party libraries

- Motion v12: [API reference](https://motion.dev/docs/react-motion-component), [docs](https://motion.dev/docs/react) (the docs follow the latest Motion, with no React API break since v12)
- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started)

## Install

```bash
npx shadcn@latest add @reui/wizard-7
```

## About Wizard blocks

### When to use

- Money tasks done in steps: account billing setup, sending an invoice, a seat upgrade or a fund transfer
- Admin intake in steps: a vendor compliance file, a store product with variants or a batch of team invites
- A long form split into 3 to 5 numbered steps with previous and next buttons and a summary before submit

### When not to use

- A first run setup right after signup that collects a profile, a role and goals: use the [Onboarding blocks](https://web.dev.reui.io/blocks/application/onboarding.md)
- Only numbered step markers and panel switching around fields you already built: use [Stepper](https://web.dev.reui.io/components/stepper.md) (`get_component("stepper")`)
- A shopper paying for a cart, entering shipping and card details beside an order summary: use the [Checkout blocks](https://web.dev.reui.io/blocks/ecommerce/checkout.md)

### Agent notes

- Steps come from `WIZARD_STEPS`, `PRODUCT_STEPS` or `PAYMENT_STEPS` in the data file, and each step id has its own render branch; add both for a new step
- No step calls an API: the final button shows a sonner `toast`, sets local state such as `isIssued`, or both; post the collected values from that handler
- Each page.tsx sets a `min-h-svh` wrapper and the full screen variants size their root to the viewport too; remove both inside an app shell or dialog

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.
