Sign in
Cards

Update Card

Updates an issued card. All fields are optional; only the fields you pass are changed. Updates the card name, billing address, and spending limits in one call, sets a new PIN, freezes or unfreezes the card, or cancels it. Pass canceled: true alone to cancel the card — cancellation is permanent and a canceled card cannot be uncanceled. Pass exactly one of account_id (a biz_ identifier) or user_id (a user_ identifier). Assigned cardholders without the payout:account:update scope can update the PIN and freeze state of their own card. The PIN can only be changed on a card assigned to the acting user. Returns the updated card resource. For a card in the invited status, the invited user completes card onboarding by passing only a billing address: their verified identity is registered with the card issuer and card provisioning starts (the card is returned and can be polled until issued). The invited user must have an approved identity verification on their Whop account. No other fields can be updated until the card is issued.

patch/cards/{card_id}

Request body

account_idstring

The owning account ID (a biz_ identifier). Provide this or user_id.

canceledboolean

Pass true to permanently cancel the card. A canceled card cannot be uncanceled. Cannot be combined with other fields.

frozenboolean

Pass true to freeze the card, false to unfreeze it.

namestring

A display name for the card.

pinstring

New 4-digit PIN. Can only be set on a card assigned to the acting user.

remove_limitboolean

Pass true to remove the spending limit (make the card unlimited).

spend_limitnumber

Spending limit amount, in dollars.

spend_limit_frequency'daily' | 'weekly' | 'monthly' | 'one_time'

The spending limit window.

transaction_limitnumber

Per-transaction limit amount, in dollars.

user_idstring

The owning user ID (a user_ identifier). Provide this or account_id.

Response

invited card onboarding completed: card provisioning started

canceled_atstring date-time nullable required

When the card was canceled.

created_atstring date-time nullable required

When the card was created.

expiration_monthstring nullable required

Card expiration month.

expiration_yearstring nullable required

Card expiration year.

idstring required

Card ID, prefixed icrd_.

last4string nullable required

Last four digits of the card number. null for pending invitation cards.

namestring nullable required

Card display name.

object'card' required
spent_last_monthinteger nullable required

Total spend in the last 30 days, in cents.

status'null' | 'active' | 'frozen' | 'canceled' | 'invited' nullable required

The card status.

type'null' | 'virtual' | 'physical' nullable required

The card type.

user_idstring nullable required

Cardholder user ID, prefixed user_, when assigned.

Changes