Card on file

Get / remove the saved payment method.

Get card

GET /v1/billing/card

Returns the saved card (display fields only — Stripe holds the PAN).

200 OK — card on file

{
  "brand": "visa",
  "last4": "4242",
  "expMonth": 12,
  "expYear": 2030,
  "pmId": "pm_1Q..."
}

200 OK — no card

{ "brand": null, "last4": null, "expMonth": null, "expYear": null, "pmId": null }

Remove card

DELETE /v1/billing/card

Detaches the saved card from your Stripe customer record and clears our local copy of the display fields.

200 OK

{ "ok": true }

After this:

• Auto-topup is automatically disabled (it needs a saved card to charge).
• The next top-up has to go through Stripe Checkout.

Update card

Use Save a payment method (SetupIntent) with a fresh card; it replaces the existing saved card automatically.