Create virtual cards

Create a cardholder and issue a virtual card.

You can use the Dashboard or the Create a card endpoint to issue virtual cards to cardholders. Cardholders can use virtual cards immediately after you create them.

Create a cardholder

You can use the Dashboard or the Cardholders API to create a cardholder.

The Cardholder object represents an individual or business entity that you can issue cards to. Create a Cardholder with a name to display on cards and the billing address. Billing address is often requested when the cardholder makes online purchases, and is usually the business address of the connected account or your platform.

When you create a cardholder, or update it later, you can include additional information such as a phone_number or email, which are required for some features like digital wallets. You can also specify preferred_locales to customize the cardholder’s language for features such as 3D Secure.

Stripe returns a Cardholder object that contains the information you provided and sends the issuing_cardholder.created webhook event.

Individual type cardholder requirements

The cardholder type defaults to individual, but you can set the type to company if you choose.

You must provide values for the first and last names of individual cardholders, which Stripe screens in accordance with regulatory guidelines. Consider also providing date of birth, which might help reduce watchlist reviews.

Accept authorized user terms

If you’re issuing cards to individuals for programs backed by Celtic Bank, you must record acceptance of the Celtic Bank Authorized User Terms before activating a card for that cardholder. See the Required Agreements for Issuing and Treasury for more information about which agreements you’re required to present to accountholders and cardholders.

If applicable, Stripe alerts you to this requirement in the requirements property of the Cardholder object:

{
  "id": "ich_1MGlTC2eZvKYlo2CJnowP9Z5",
  "name": "Jenny Rosen",
  ...
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": [
      "individual.card_issuing.user_terms_acceptance.date",
      "individual.card_issuing.user_terms_acceptance.ip",
    ],
  },
  ...
}

You can accept the terms on behalf of the Cardholder by passing in the Unix timestamp of when the cardholder accepted their terms and also their IP address.

When you’ve met the requirements for card activation (such as first and last names, plus proof of user terms acceptance) you can activate cards for them.

Create a card

Create a Card and assign it to the cardholder. This request contains the ID of the Cardholder object, currency, and virtual for the card type.

Stripe returns a Card object upon creation, and sends the issuing_card.created webhook event.

Activate the card

For authorizations to be approved on a card, its status must be set to active. Past-due requirements block card activation.

Activate on creation

You can activate the card when creating it using the Dashboard or the API. In the Dashboard, when creating a card, click Activate card. Using the API, set status to active when using the create card endpoint.

Activate after creation

Alternatively, after creating an inactive card, you can activate it using the Dashboard or the API. To activate it using the Dashboard, select the card you want to activate, then click Activate card. To activate it using the API, use the update card endpoint to set its status to active.

Re-activate after blocking

In some cases, multiple incorrect PIN attempts on a transaction deactivates a card, preventing further authorizations. To reactivate the card, use the Dashboard or the update card API to set the card’s status to active.