# Add a payment card

`POST /v1/billing/cards`

**In this build:** Uses a stand-in for an external service. Records a card at once. A real flow opens the payment provider's checkout and records the card when it returns.

**Scope:** `billing.write`

**CLI:** `harebox billing card`

## Response: 201

`PaymentLink`

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

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