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

# Flow of Funds

> From provisioning a fiat receiving rail to a payout — every money movement mapped to a Platform API call, object, and webhook.

<div className="hop-lede">Every money movement maps to a Platform API object: <span className="hop-strong">money in</span> is a Deposit (<code>api\_</code>) credited to a virtual account when funds settle; <span className="hop-strong">money out</span> is a Payment (<code>apo\_</code>) from a virtual account to a Beneficiary’s bank-account Payment Destination; <span className="hop-strong">internal moves</span> are same-account, same-currency Transfers (<code>atx\_</code>) between virtual accounts.</div>

<div className="hop-flow hop-flow-fof">
  <div className="hop-controls">
    <span className="hop-controls-label">Funding rail</span>

    <div className="hop-toggle" role="group" aria-label="Funding rail">
      <input id="fof-mode-fiat" type="radio" className="hop-mode-input" name="fof-mode" defaultChecked />

      <label htmlFor="fof-mode-fiat"><span className="hop-toggle-dot" />Fiat · Virtual account</label>
    </div>
  </div>

  <div className="hop-prereq">↳ <span className="hop-strong">Prerequisite:</span> the account is already <span className="hop-strong">approved</span> and any required agreements have been accepted — see the <a href="/va/flows/kyb-onboarding">onboarding flow</a>. Funds movement begins once onboarding has completed.</div>

  <div className="hop-legend" aria-label="Flow legend">
    <span className="hop-legend-item"><span className="hop-pill hop-post"><span className="hop-method">POST</span></span>write</span>
    <span className="hop-legend-item"><span className="hop-pill hop-get"><span className="hop-method">GET</span></span>read</span>
    <span className="hop-legend-item"><span className="hop-pill hop-webhook">webhook</span>event you receive</span>
    <span className="hop-legend-item"><span className="hop-pill hop-rail">Bank rail</span>external rail</span>
    <span className="hop-legend-item"><span className="hop-pill hop-object">api\_</span>resource created</span>
    <span className="hop-legend-item hop-actor-key hop-actor-platform">— Platform</span>
    <span className="hop-legend-item hop-actor-key hop-actor-hop">— Hop</span>
    <span className="hop-legend-item hop-actor-key hop-actor-customer">— End customer</span>
  </div>

  <div className="hop-scroll">
    <div className="hop-phases" aria-hidden="true">
      <div className="hop-phase hop-span-2">Provision</div>
      <div className="hop-phase hop-span-2">Collect — money in</div>
      <div className="hop-phase hop-span-1">Hold</div>
      <div className="hop-phase hop-span-1">Move</div>
      <div className="hop-phase hop-span-4">Pay — money out</div>
    </div>

    <div className="hop-swim">
      <div className="hop-lane">
        <div className="hop-lane-label">
          <span className="hop-lane-bar hop-lane-platform" />

          <span>Platform<span className="hop-lane-subtitle">you</span></span>
        </div>

        <div className="hop-track">
          <div className="hop-slot">
            <a href="/va/virtual-accounts/create-virtual-account" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">1</span>
              <span className="hop-step-title">Provision a virtual account (one per currency)</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-post"><span className="hop-method">POST</span>/accounts/\{id}/virtual-accounts</span>
                <span className="hop-pill hop-webhook">virtual\_account.created</span>
                <span className="hop-pill hop-object">va\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot">
            <a href="/va/virtual-accounts/get-virtual-account" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">2</span>
              <span className="hop-step-title">Wait for activation, then surface deposit instructions</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-webhook">virtual\_account.updated</span>
                <span className="hop-pill hop-get"><span className="hop-method">GET</span>/virtual-accounts/\{id}</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot">
            <a href="/va/virtual-accounts/get-virtual-account" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">5</span>
              <span className="hop-step-title">Read the updated balance on the virtual account</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-get"><span className="hop-method">GET</span>/virtual-accounts/\{id}</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot">
            <a href="/va/transfers/create-transfer" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">6</span>
              <span className="hop-step-title">Move funds between this account’s virtual accounts (optional)</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-post"><span className="hop-method">POST</span>/accounts/\{account\_id}/transfers</span>
                <span className="hop-pill hop-object">atx\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot">
            <a href="/va/beneficiaries/create-beneficiary" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">7</span>
              <span className="hop-step-title">Create the recipient as a beneficiary</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-post"><span className="hop-method">POST</span>/accounts/\{account\_id}/beneficiaries</span>
                <span className="hop-pill hop-object">bene\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot">
            <a href="/va/payment-destinations/create-payment-destination" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">8</span>
              <span className="hop-step-title">Add a bank-account payment destination</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-post"><span className="hop-method">POST</span>…/payment-destinations</span>
                <span className="hop-pill hop-object">dest\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot">
            <a href="/va/payments/create-payment" data-link-label="API ↗" className="hop-step hop-step-platform">
              <span className="hop-step-number">9</span>
              <span className="hop-step-title">Send the payment — hold funds, review, process, settle</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-post"><span className="hop-method">POST</span>/accounts/\{account\_id}/payments</span>
                <span className="hop-pill hop-webhook">payment.created → payment.completed</span>
                <span className="hop-pill hop-object">apo\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot" />
        </div>
      </div>

      <div className="hop-lane">
        <div className="hop-lane-label">
          <span className="hop-lane-bar hop-lane-hop" />

          <span>Hop<span className="hop-lane-subtitle">API · funds processing</span></span>
        </div>

        <div className="hop-track">
          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot">
            <a href="/va/deposits/get-deposit" data-link-label="API ↗" className="hop-step hop-step-hop">
              <span className="hop-step-number">4</span>
              <span className="hop-step-title">Hop creates a deposit and credits the virtual account</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-webhook">deposit.received</span>
                <span className="hop-pill hop-get"><span className="hop-method">GET</span>…/deposits/\{deposit\_id}</span>
                <span className="hop-pill hop-object">api\_</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />
        </div>
      </div>

      <div className="hop-lane">
        <div className="hop-lane-label">
          <span className="hop-lane-bar hop-lane-customer" />

          <span>End customer<span className="hop-lane-subtitle">& counterparties</span></span>
        </div>

        <div className="hop-track">
          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot">
            <a href="/va/deposits/get-deposit" data-link-label="API ↗" className="hop-step hop-step-customer">
              <span className="hop-step-number">3</span>
              <span className="hop-step-title">Payer sends funds over a supported bank rail</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-rail">ACH · Fedwire · SWIFT · SEPA · SPEI · PIX · Faster Payments</span>
              </span>

              <span className="hop-chevron">›</span>
            </a>
          </div>

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot" />

          <div className="hop-slot">
            <a href="/va/payments/get-payment" data-link-label="API ↗" className="hop-step hop-step-customer">
              <span className="hop-step-number">10</span>
              <span className="hop-step-title">Customer sees the receipt and updated balance</span>

              <span className="hop-step-pills">
                <span className="hop-pill hop-webhook">payment.completed · payment.returned</span>
                <span className="hop-pill hop-get"><span className="hop-method">GET</span>/virtual-accounts/\{id}</span>
              </span>
            </a>
          </div>
        </div>
      </div>
    </div>
  </div>

  <p className="hop-hint">Tip: select any card to open the related API reference. Scroll down to follow the flow ↓</p>
  <div className="hop-footnote">Money in: Deposit (<code>api\_</code>) credited to a virtual account. Money out: Payment (<code>apo\_</code>) from a virtual account to a Beneficiary’s bank-account Payment Destination. Internal moves: same-account, same-currency Transfer (<code>atx\_</code>) between virtual accounts.</div>
</div>