Withdrawals | Coinflow

Withdrawing funds from accounts

An embedded account can withdraw its balance to one of its own payout methods, such as a bank account, wire, or debit card. Withdrawals are drawn from that embedded account’s balance only. Your primary account and other embedded accounts are not affected.

An embedded account can withdraw when:

It is verified. See Verification.
It has at least one payout method that supports the speed you choose.
It has a balance, and the withdrawal doesn’t take it below your configured minimum balance.
It has no other pending transfer or withdrawal.

Setting up payout methods

Embedded account withdrawals support ACH, RTP, wire, Swift, and push to card.

Payout methods are added with the Coinflow API, the same way as for any withdrawer, using the embedded account ID as the withdrawer’s wallet. See Payout Overview.

Withdrawing from the dashboard

Open Embedded Accounts

In the Merchant Dashboard, open Embedded Accounts under General in the sidebar, then expand the group that contains the account.

Start the withdrawal

Select the Withdrawal action on the account’s row. It appears only when the account has a balance and no pending transfer or withdrawal.

Choose where and how fast

Under To, choose one of the account’s payout methods. Under Speed, choose one of the speeds that payout method supports.

Enter the amount

Enter an amount up to the account’s available balance, less any minimum balance, and submit.

If the account isn’t verified or has no payout methods, the dialog explains why withdrawals are unavailable.

Withdrawing with the API

curl --request POST \
  --url https://api-sandbox.coinflow.cash/api/merchant/accounts/withdraws \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "accountId": "EMBEDDED_ACCOUNT_ID",
    "token": "PAYOUT_METHOD_TOKEN",
    "speed": "standard",
    "amount": {"cents": 10000}
  }'

A successful request returns 204 No Content.

Field	Description
`accountId`	The ID of the embedded account to withdraw from.
`token`	The token of the payout method to send funds to.
`speed`	The payout speed. Must be supported by the selected payout method: `standard` or `same_day` (ACH), `asap` (RTP instant bank payout), `wire`, `card`, or `swift`.
`amount`	The amount to withdraw, in cents.

To list an embedded account’s payout methods and the speeds each one supports, call:

curl --request GET \
  --url https://api-sandbox.coinflow.cash/api/merchant/accounts/withdraws/options/EMBEDDED_ACCOUNT_ID \
  --header 'Authorization: YOUR_API_KEY'

[
  {
    "alias": "Business Checking",
    "token": "PAYOUT_METHOD_TOKEN",
    "speeds": ["same_day", "standard"]
  }
]

The values above (EMBEDDED_ACCOUNT_ID, PAYOUT_METHOD_TOKEN, the alias, and the amount) are examples only. Use your embedded account’s ID from the Embedded Accounts page in the Merchant Dashboard and a token returned by the payout options request.

Tracking a withdrawal

Each withdrawal appears in the account’s transfer history as a Distribution entry. Once the payout has been sent, the entry also shows the payout fee. Until the funds have left the embedded account, the withdrawal counts as the account’s pending transfer, so the account can’t start another transfer or withdrawal in the meantime. The payout itself can take longer to arrive, depending on the speed you chose.

Returned withdrawals

If a withdrawal is returned, for example by the receiving bank, the full withdrawn amount is credited back to the embedded account it came from. The credit appears in the account’s transfer history as an incoming transfer.