Card Required

card-required · 402

The account has no card on file, so the API won't run compute for it.

A card, or an invoice arrangement an operator granted, lets an account run compute.

Besides the members every error carries, this type adds billingUrl.

Common causes

  • The account never added a card.

How to fix the call

  • Tell the user to add a card at billingUrl: it's theirs to do.
  • Then send the same call again.
  • Read what stands in the way with ghaym cloud billing eligibility, or GET /v1/billing/eligibility, before trying again.

Example response

json
{
  "type": "card-required",
  "title": "Card Required",
  "detail": "A card on file is required to run compute. Add one at https://auth.ghaym.me/account/billing.",
  "billingUrl": "https://auth.ghaym.me/account/billing",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services",
  "method": "POST",
  "instance": "POST /v1/projects/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/services",
  "status": 402,
  "docs": "https://ghaym.me/docs/errors/card-required"
}