GuidesRecipesAPI ReferenceChangelog
Guides

Transfer Process

Understand fiat and crypto transfer types, lifecycle states, and how transfers fit into the Cybrid trading flow.

Overview

The Cybrid platform enables fund transfers for both fiat currencies (USD, CAD) and cryptocurrencies (BTC, USDC) through the transfers endpoints.

Transfer types

TypeDescription
FundingFiat deposits and withdrawals to Plaid-connected bank accounts via EFT or ACH.
BookInternal transfers between accounts on the platform. Typically used with a pre-funded account model. See Trade Process for details.
CryptoCrypto withdrawals to pre-registered external wallets. Crypto deposits are not initiated from Cybrid, but transfers are created to record incoming deposits.

Where transfers fit in

Transfers bookend the trading activity on the platform. A typical flow looks like this:

Diagram showing the transfer flow: fund fiat account, trade, then withdraw crypto

Transfer states

After creating a transfer via POST /api/transfers, it progresses through these states:

  1. storingreviewing — immediate transition after creation.
  2. reviewingpending — the payment processor completes initial processing (typically a few minutes).
  3. pendingcompleted or failed — the payment processor finishes processing the transfer.
ℹ️

Compliance review

If a transfer is flagged for compliance review, it remains in reviewing until the review completes, then transitions directly to completed or failed.

When a transfer reaches failed, the failure_code field contains the reason for failure.