IssuingCard

Source: src/Stripe/IssuingCard.ts

A Stripe Issuing Card — a virtual or physical card issued to a Cardholder. cardholder, currency, type, secondLine, and custom expiration are immutable (changing them replaces the card). Status, spending controls, personalization design, and metadata update in place.

Cards cannot be hard-deleted; destroying this resource cancels the card (status: canceled). Canceled cards cannot be reactivated — a later create with the same logical id provisions a new card.

Issuing must be enabled on the Stripe account.

Creating a Card

Virtual card

const card = yield* Stripe.IssuingCard("expense-card", {
  cardholder: cardholder.id,
  currency: "usd",
  type: "virtual",
  status: "inactive",
});

Spending limits and metadata

const card = yield* Stripe.IssuingCard("expense-card", {
  cardholder: cardholder.id,
  currency: "usd",
  type: "virtual",
  status: "active",
  spendingControls: {
    spendingLimits: [{ amount: 50_000, interval: "monthly" }],
  },
  metadata: { team: "ops" },
});

Updating a Card

const card = yield* Stripe.IssuingCard("expense-card", {
  cardholder: cardholder.id,
  currency: "usd",
  type: "virtual",
  status: "inactive",
  metadata: { team: "ops", frozen: "true" },
});

Replacing a Card

const card = yield* Stripe.IssuingCard("expense-card", {
  cardholder: cardholder.id,
  currency: "usd",
  type: "physical",
});