Settlement and Payment Lock Time

How long ACH Pull and Debit Card funds are held before they settle.

When a Customer pays by ACH Pull or Debit Card, the funds are on hold until the bank clears the payment. This is the settlement period.

Settlement Period

Payment MethodSettlement PeriodDescription
Debit CardT+1Funds settle one business day after the transaction is initiated.
ACH PullT+2Funds settle two business days after the transaction is initiated.

Business days don't include weekends or U.S. federal holidays. The period ends at the same time of day the transfer started. There's no daily cutoff.

When the Funds Arrive

What happens during the hold depends on where the USDC goes.

External Wallet Address

  • The USDC arrives after the hold ends.
  • Until then, the transfer is pending_harbor. It becomes completed when Harbor sends the USDC.

Internal Wallet (Wallet API)

  • The USDC arrives right away, and the transfer is completed.
  • The funds are locked. You can't withdraw or transfer them until the hold ends.

Check Locked Funds

Get the internal wallet's balances:

GET /api/v1/wallets/{wallet_uuid}/balances

{
    "data": [
        {
            "asset": "USDC",
            "total_amount": "100.000000",
            "locked_amount": "40",
            "available_amount": "60.000000"
        }
    ]
}
  • locked_amount: the funds you can't move yet.
  • available_amount: the funds you can move.

Each record in the wallet's records has is_locked, lock_status and lock_release_at. See Get Wallet Records.

If you try to move more than available_amount, Harbor rejects it with "Insufficient available balance" (code 100801).

Harbor unlocks the funds by itself when the hold ends. If the bank is late to confirm, the lock lasts longer.

Example: ACH Pull on a Friday

ACH Pull takes 2 business days. This transfer starts on a Friday at 14:30:

  • Friday, 14:30: the transfer starts.
  • Saturday and Sunday: not business days.
  • Monday: business day 1.
  • Tuesday, 14:30: business day 2. The hold ends.

On Tuesday, Harbor unlocks the funds in an internal wallet, or sends the USDC to an external wallet.

Transfer Status

  • pending_customer_transfer_start with sub_status awaiting_settlement: the pull started, and Harbor waits for the bank to confirm it. This is short.
  • pending_harbor: the bank confirmed the pull, and the hold runs.
{
    "data": {
        "uuid": "transfer_...",
        "type": "on-ramp",
        "status": "pending_customer_transfer_start",
        "sub_status": "awaiting_settlement",
        ...
    }
}
{
    "data": {
        "uuid": "transfer_...",
        "type": "on-ramp",
        "status": "pending_harbor",
        "sub_status": null,
        ...
    }
}

See Transfer Lifecycle.


Notes

  • Funds are locked to protect against ACH returns, for example when the account has insufficient funds or the debit was not authorized.
  • If the bank returns an ACH debit, the transfer becomes reject. Harbor doesn't send a webhook for this, so check the transfer's status yourself.

Did this page help you?