Withdrawing

Withdrawing customer funds is the act of redeeming funds from a customer’s brokerage account to a directed bank account.

📘

Redemptions vs Withdrawals?

Redemptions and withdrawals mean the same thing and are used throughout the Guides and API Reference interchangeably.

Accounts have a defined amount that can be removed from the DriveWealth platform at any given time, known as the Cash Available for Withdrawal. This can be viewed in the Retrieve money details by Account API:

GET /back-office/accounts/{accountID}/summary/money
{
  "accountID": "cc07f91b-7ee1-4868-b8fc-823c70a1b932.1407775317759",
  "accountNo": "DWBG000052",
  "tradingType": "CASH",
  "updated": "2022-12-25T18:41:32.440Z",
  "cash": {
    "cashAvailableForTrade": 400.0,
    "cashAvailableForWithdrawal": 200.0,
    "cashBalance": 400,
    "noBuyingPowerReason": [],
    "cashSettlement": [
      {
        "utcTime": "2021-04-26T13:30:00.001Z",
        "cash": 200.0
      }
    ],
    "pendingPaymentsAmount": 0.00
  },
  ...
}

This Account above has $200 that can be withdrawn.

Withdrawal flow lifecycle

Withdrawals have a lifecycle in which they can inform a partner about the status of a particular Withdrawal. To understand more about the Withdrawal lifecycle flow see below:

Advisory flow lifecycle

Managing advisory Withdrawals are a bit different than regular Withdrawals. In self-directed Accounts, it is expected that customers must sell positions to make cash available. In managed Accounts, a customer may be fully invested in securities without a way to create a sale order on their own.

If you're using DriveWealth's AutoPilot functionality, it will handle this process of selling securities to make cash available. When AutoPilot sees a withdrawal being requested, AutoPilot will automatically create sell orders during the next run to raise enough funds for the withdrawal based on the weights in the portfolios.

Without AutoPilot, the advisor would have to sell securities in the individual customer's brokerage account to raise the funds. Once the funds become available for withdrawal, the Advisory can then put in the Withdrawal request.

Justin wants to make a withdrawal of $250.00 from his robo-advisory brokerage account. He put his withdrawal in on January 3, 2023 before 10:00 AM ET. AutoPilot recognizes his withdrawal request and creates sell orders that morning at 10:45 AM ET. AutoPilot successfully sells enough securities to raise the $250.00 for Justin’s withdrawal on January 3, 2023. The platform will automatically wait for settlement day which will make the cash available for withdrawal (Trade Day + 2, aka T+2) which is January 5, 2023. The system will see cash available and will fire off the withdrawal sequence.

🚧

There is lead time on any AutoPilot-enabled account withdrawal is at least 2 business days, as cash must be first sold, then settled, before it can be withdrawn.

Individual withdrawals

An individual Withdrawal is a single movement of funds from a customer’s brokerage account directly to the originating banking account or to a destination explicitly specified by the customer.

Here is an example of using ACH to deduct a specific amount to a customer's bank:

POST - /back-office/funding/redemptions
{
     "accountNo": "DWBG000052",
     "amount": 125.92,
     "type": "ACH_MANUAL",
     "currency": "USD",
     "details": {
          "beneficiaryName": "Justin Smith",
          "beneficiaryAccountNumber": "00257596002028990212396",
          "beneficiaryAccountType": "CHECKING",
          "beneficiaryRoutingNumber": "021000322",
          "beneficiaryBankName": "Bank of America",
          "beneficiaryBankAddress": "222 BROADWAY",
          "beneficiaryBankCity": "New York City",
          "beneficiaryBankProvince": "New York",
          "beneficiaryBankZip": "10038",
          "beneficiaryBankCountry": "USA"
     }
}

Bulk withdrawals

Bulk Withdrawals are aggregations of Withdrawals from individual customers over the course of a day. Bulking lowers costs of transfers and decreases chances of failures.

Bulk Withdrawals are processed from 00:00:00.000 to 23:59:59.999 UTC for an aggregated bulk Withdrawal. This means all bulk Withdrawals submitted during these times will be included in the next bulk Withdrawal settlement report.

Bulk Withdrawals are still initiated from the individual customer account, but the money is moved to a partner's Bulk Withdrawal House Account—a unique Account set up by DriveWealth to represent money being returned via bulk Withdrawal:

POST /back-office/funding/redemptions
{
    "accountNo": "DWKU000293",
    "amount": 20,
    "currency": "USD",
    "type": "CASH_TRANSFER",
    "details": {
      "partnerAccountNo": "DWUU000266"
    },
    "note": "I need some funds"
}

After money is moved to the Bulk Withdrawal House Account, instructions for the bulk Withdrawal are similar to individual Withdrawal instructions for customers—but the account number specified is that of this unique Account.

POST - /back-office/funding/redemptions
{
     "accountNo": "TTCC000052",
     "amount": 55234.50,
     "type": "WIRE",
     "currency": "USD",
     "details": {
          "beneficiaryName": "Tendies Trading Co",
          "beneficiaryAccountNumber": "21977082",
          "beneficiaryAccountType": "CHECKING",
          "beneficiaryRoutingNumber": "021000322",
          "beneficiaryBankName": "Bank of America",
          "beneficiaryBankAddress": "222 BROADWAY",
          "beneficiaryBankCity": "New York City",
          "beneficiaryBankProvince": "New York",
          "beneficiaryBankZip": "10038",
          "beneficiaryBankCountry": "USA"
     }
}

🚧

Wire or ACH instructions for the customer funds in the Partner Bulk Withdrawal House Account must be received by 10:29.59.999 ET to be processed same day.

📌 Note this is Eastern Time and not Coordinated Universal Time.