# Add money to the wallet

`POST /v1/billing/wallet/payments`

**In this build:** Uses a stand-in for an external service. Credits the wallet immediately. A real provider would credit after payment.

**Scope:** `billing.write`

**CLI:** `harebox wallet pay`

Send an `Idempotency-Key` header. A retry with the same key never repeats the action.

## Request: `WalletPayRequest`

| Field | Type | Notes |
|---|---|---|
| `dollars` (required) | `integer` |  |

## Response: 201

`PaymentLink`

| Field | Type | Notes |
|---|---|---|
| `url` (required) | `string` |  |

Errors follow [one format](../errors.html).