Skip to main content

Issue a card

POST 
/v1/cards

Issues a virtual or a physical card for an account.

A virtual card needs no more than the cardholder and the account. A physical card also needs embossed_name, the name printed on it, and a delivery_address. To have plastic made for a card you already hold, use POST /v1/cards/{card_id}/request-physical instead.

The response only includes last_four. The full card number and CVV are never returned here. Getting them is a separate, separately scoped and audited operation.

A card is never usable straight away. It goes through the same statuses on every program:

  1. It starts as pending while the processor issues it. On a program that issues at once, the response already says inactive.
  2. It becomes inactive when the processor has the card, and you get card.issued.
  3. It becomes active when you call POST /v1/cards/{card_id}/activate, and you get card.activated. Until then every authorization is declined.

Request​

Responses​

Card accepted. pending while the processor issues it, or inactive on a program that issues at once.