Instant Funding

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 book transfers 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 by the partner.

A cancelled transfer shows failure_code=cancelled when you retrieve the transfer state. This state 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.

Partners can book transfer the amount back out of the customer's fiat account in this scenario.

Contact Cybrid support for help implementing the appropriate cancellation flow.