# deposit.now — full agent guide (honest)

## What this is

An **open x402 funding rail** on Base:

1. You already have a **target** EVM address (deposit.now does not create wallets).
2. You POST net `amount` + `target`.
3. You pay **amount + 1%** via x402 to the platform.
4. After settlement, the platform **forwards net** to `target` (async; can fail).
5. Optional **public receipt** at `/receipt/{id}` when storage is configured.

## What this is not

- Not a replacement for **Coinbase CDP Fund / Send** inside Agentic or Server Wallets.
- Not a wallet factory or sub-account product.
- Not a guarantee that funds are on `target` when HTTP 200 returns.

## When to use what

| Situation | Prefer |
|-----------|--------|
| Agents already on Coinbase Agentic / Server Wallets | CDP **Fund** / **Send** |
| Need open HTTP 402 deposit to any address | **deposit.now** |
| One-off raw transfer you fully control | Direct on-chain USDC transfer |

## Protocol

1. `POST https://deposit.now/api/deposit`
   ```json
   { "target": "0x…", "amount": "50.00", "memo": "optional" }
   ```
2. **402** with gross price = amount + 1%.
3. Pay with any x402 v2 exact client; retry with payment proof.
4. **200** body uses `status: "payment_received"` and `forwardStatus: "pending"` until settlement finishes forwarding.
5. Poll or open `receiptUrl` for `forwardStatus` (`settled` | `forward_failed` | `pending`), `forwardTxHash`, payer, target, Basescan links.

## Success does not mean delivered

| Field | Meaning |
|-------|---------|
| paymentReceived: true | x402 payment accepted |
| status: payment_received | Same — not “target funded” |
| forwardStatus: settled | Net forward tx recorded |
| forwardStatus: forward_failed | Payment in; forward failed |
| receipt missing | Storage may be unconfigured or settlement lag |

## Field reference

| Field  | Required | Description |
|--------|----------|-------------|
| target | yes | EVM address receiving net funds |
| amount | yes | Net USDC for target, 0.01 – 100000 |
| memo   | no  | ≤ 256 chars |

## Security notes

- Paying agent holds its own key; deposit.now server uses CDP for platform hot wallet.
- Never put platform private keys in client code.
- Concurrent deposits of the same gross amount may race on intent recovery — always send the same JSON body on the paid retry.

## Links

- Docs: https://deposit.now/docs
- OpenAPI: https://deposit.now/openapi.json
- Short llms: https://deposit.now/llms.txt