IssuingCardholder

Source: src/Stripe/IssuingCardholder.ts

A Stripe Issuing Cardholder — an individual or company who can be issued cards. Billing address, email, phone, preferred locales, spending controls, status, and metadata update in place. Name and type are immutable; changing them replaces the cardholder.

Stripe does not hard-delete cardholders; destroying this resource sets status to inactive. Inactive cardholders can be reactivated by a later reconcile.

Requires the Stripe Issuing entitlement.

Creating a Cardholder

Individual with billing address

const alice = yield* Stripe.IssuingCardholder("alice", {
  name: "Alice Example",
  type: "individual",
  email: "alice@example.com",
  billing: {
    address: {
      line1: "123 Main Street",
      city: "San Francisco",
      state: "CA",
      postalCode: "94111",
      country: "US",
    },
  },
  individual: { firstName: "Alice", lastName: "Example" },
});

Company cardholder

const acme = yield* Stripe.IssuingCardholder("acme", {
  name: "Acme Corp",
  type: "company",
  billing: {
    address: {
      line1: "1 Market Street",
      city: "San Francisco",
      state: "CA",
      postalCode: "94105",
      country: "US",
    },
  },
  company: { taxId: "12-3456789" },
});

Spending controls

const alice = yield* Stripe.IssuingCardholder("alice", {
  name: "Alice Example",
  billing: {
    address: {
      line1: "123 Main Street",
      city: "San Francisco",
      state: "CA",
      postalCode: "94111",
      country: "US",
    },
  },
  spendingControls: {
    spendingLimits: [{ amount: 10000, interval: "monthly" }],
    spendingLimitsCurrency: "usd",
  },
});

Updating a Cardholder

const alice = yield* Stripe.IssuingCardholder("alice", {
  name: "Alice Example",
  email: "alice+updated@example.com",
  phoneNumber: "+15555550100",
  billing: {
    address: {
      line1: "123 Main Street",
      city: "San Francisco",
      state: "CA",
      postalCode: "94111",
      country: "US",
    },
  },
  metadata: { team: "ops" },
});

Deactivating a Cardholder

// stack.destroy() / resource removal sets status to inactive
const alice = yield* Stripe.IssuingCardholder("alice", {
  name: "Alice Example",
  billing: {
    address: {
      line1: "123 Main Street",
      city: "San Francisco",
      state: "CA",
      postalCode: "94111",
      country: "US",
    },
  },
});