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 Method | Settlement Period | Description |
|---|---|---|
| Debit Card | T+1 | Funds settle one business day after the transaction is initiated. |
| ACH Pull | T+2 | Funds 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 becomescompletedwhen 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_startwithsub_statusawaiting_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.
Updated about 14 hours ago