Skip to main content

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.