GuidesRecipesAPI ReferenceChangelog
Guides

Instant Funding

How do I execute an instant funding transfer?

The Cybrid Platform offers instant funding to accelerate settlement of ACH/EFT fiat deposit transfers.

To use this feature, partners must create and pre-fund their bank-level fiat account.

When a bank submits an instant funding deposit transfer on behalf of a customer, the platform initiates a book transfer of the fiat amount from the partner's pre-funded bank-level fiat account to the customer's fiat account.

Once the ACH is approved and submitted to the banking rails, the customer's fiat account is credited and the funds are instantly available.

When the ACH ultimately settles, the fiat amount becomes available in the partner's bank-level fiat account.

Steps

Once the bank-level fiat account is pre-funded, follow these steps to execute an instant funding transfer:

  1. Create a quote using POST /api/quotes:
    • Set product_type to "funding"
    • Set asset to "USD"
    • Set side to "deposit"
    • Provide the customer_guid
    • Set receive_amount to the deposit amount in base units (e.g., 100 for $1 USD)
{
  "product_type": "funding",
  "asset": "USD",
  "side": "deposit",
  "customer_guid": "<customer_guid>",
  "receive_amount": 100
}
ℹ️

Deposit only

Instant funding transfers are only available for side=deposit quotes.

  1. Create a transfer using POST /api/transfers:
    • Set transfer_type to "instant_funding"
    • Set quote_guid to the quote GUID from step 1
    • Set external_bank_account_guid to the customer's external bank account
{
  "transfer_type": "instant_funding",
  "quote_guid": "<quote_guid>",
  "external_bank_account_guid": "<external_bank_account_guid>"
}
⚠️

Participants required

The API requires source_participants and destination_participants for instant funding transfers. These fields are omitted from the example above because values are partner-specific. Contact partner support for guidance on participant configuration.

  1. Once submitted, the fiat funds are available in the customer's fiat account when the transfer reaches the "pending" state.
ℹ️

Pending state behavior

While funds are available once the transfer enters "pending" state, the transfer remains in "state": "pending" until the same-day ACH completes. It then progresses to "state": "completed".

Cancelled Instant Funding Transfers

Like regular funding transfers, instant funding transfers can be cancelled if the bank has not yet accepted the transfer for processing.

Cancelled instant funding transfers may require additional action from the partner.

A cancelled transfer shows failure_code=cancelled when you retrieve the transfer state. This means:

  1. The book transfer from the bank-level fiat account to the customer-level fiat account has completed — the customer has the funds.
  2. The ACH/EFT transfer from the customer's connected bank account to the platform has not completed — the bank does not have the funds.

To recover the funds, initiate a book transfer to return the amount from the customer's fiat account.

Contact Cybrid support for help implementing the appropriate cancellation flow.

ACH Pull, Instant Funding, and Return Risk

ACH pull operates on batch settlement with return windows. Even after you receive a completed webhook for a funding transfer, the debit at the customer's bank may not yet be reflected. The webhook indicates the transfer has been submitted and accepted into the ACH flow — not that final settlement has occurred. Returns (for insufficient funds or unauthorized transactions) are still possible within NACHA return timeframes.

For instant funding (prefunded model), you must prefund your Cybrid account. The end user is credited immediately while the ACH debit is still in flight. However, return risk remains. If the customer's bank returns the ACH (e.g., insufficient funds or revoked authorization), the loss is covered from your Reserve account. ACH returns are not guaranteed to never occur. Mitigate risk through limits, velocity controls, user history, and Plaid/balance checks.

RTP and FedNow Instant Funding

Availability

RTP and FedNow are supported for instant withdrawals and deposits. Note that the receiving or sending bank (outside of Cybrid) must also support RTP or FedNow for the transfer to succeed.

API Integration

To initiate an RTP or FedNow transfer, set the following parameters on POST /api/transfers:

  • transfer_type: "funding"
  • payment_rail: "rtp" (auto-routes between RTP and FedNow as appropriate)
{
  "transfer_type": "funding",
  "payment_rail": "rtp",
  "quote_guid": "<quote_guid>",
  "external_bank_account_guid": "<external_bank_account_guid>"
}

No additional configuration is required if instant funding is already enabled.

Limits

  • Up to $500,000 per transaction (standard daily customer limits still apply)

Fees

  • RTP: $1.00 per transaction
  • ACH: $0.25 (credit), $0.55 (debit)

Coverage

RTP and FedNow support instant withdrawals 24/7. Deposits are push only (not equivalent to ACH pull).

To enable, select the appropriate payment rail when creating a transfer.

Updated 18 days ago