Sign in

v1

latestOpenAPI 3.0.02026-07-248834.9 KB
Card

Create card

Create a new virtual card.

post/cards

Request body

exp_monthstring

Two digit (MM) expiry month. If neither exp_month nor exp_year is provided, an expiration date will be generated.

exp_yearstring

Four digit (yyyy) expiry year. If neither exp_month nor exp_year is provided, an expiration date will be generated.

funding_tokenstring uuid

The token for the desired FundingAccount to use when making transactions with this card.

memostring

Friendly name to identify the card.

spend_limitinteger

Amount (in cents) to limit approved authorizations. Transaction requests above the spend limit will be declined.

spend_limit_duration'ANNUALLY' | 'FOREVER' | 'MONTHLY' | 'TRANSACTION'

Spend limit duration values:

  • ANNUALLY - Card will authorize transactions up to spend limit in a calendar year.
  • FOREVER - Card will authorize only up to spend limit for the entire lifetime of the card.
  • MONTHLY - Card will authorize transactions up to spend limit for the trailing month. Month is calculated as this calendar date one month prior.
  • TRANSACTION - Card will authorizate multiple transactions if each individual transaction is under the spend limit.
state'OPEN' | 'PAUSED'

Card state values:

  • OPEN - Card will approve authorizations (if they match card and account parameters).
  • PAUSED - Card will decline authorizations, but can be resumed at a later time.
type'DIGITAL_WALLET' | 'MERCHANT_LOCKED' | 'SINGLE_USE' | 'UNLOCKED' required

Card types:

  • DIGITAL_WALLET - Cards that can be provisioned to a digital wallet like Google Pay or Apple Wallet. A subscription is required to create these cards.
  • MERCHANT_LOCKED - Card is locked to first merchant that successfully authorizes the card.
  • SINGLE_USE - Card will close shortly after the first transaction.
  • UNLOCKED - Card will authorize at any merchant. Creating these cards requires additional privileges.

Example request

{
  "exp_month": "06",
  "exp_year": "2027",
  "funding_token": "ecbd1d58-0299-48b3-84da-6ed7f5bf9ec1",
  "memo": "New Card"
}

Response

OK

createdstring date-time required

An ISO 8601 timestamp for when the card was created. UTC time zone.

exp_monthstring

Two digit (MM) expiry month.

exp_yearstring

Four digit (yyyy) expiry year.

hostnamestring

Hostname of card's locked merchant (will be empty if not applicable).

last_fourstring required

Last four digits of the card number.

memostring

Friendly name to identify the card.

spend_limitinteger required

Amount (in cents) to limit approved authorizations. Transaction requests above the spend limit will be declined.

spend_limit_duration'ANNUALLY' | 'FOREVER' | 'MONTHLY' | 'TRANSACTION' required

Spend limit duration values:

  • ANNUALLY - Card will authorize transactions up to spend limit in a calendar year.
  • FOREVER - Card will authorize only up to spend limit for the entire lifetime of the card.
  • MONTHLY - Card will authorize transactions up to spend limit for the trailing month. Month is calculated as this calendar date one month prior.
  • TRANSACTION - Card will authorizate multiple transactions if each individual transaction is under the spend limit.
state'CLOSED' | 'OPEN' | 'PAUSED' required

Card state values:

  • CLOSED - Card will no longer approve authorizations. Closing a card cannot be undone.
  • OPEN - Card will approve authorizations (if they match card and account parameters).
  • PAUSED - Card will decline authorizations, but can be resumed at a later time.
tokenstring uuid required

Globally unique identifier.

type'DIGITAL_WALLET' | 'MERCHANT_LOCKED' | 'SINGLE_USE' | 'UNLOCKED' required

Card types:

  • DIGITAL_WALLET - Cards that can be provisioned to a digital wallet like Google Pay or Apple Wallet.
  • MERCHANT_LOCKED - Card is locked to first merchant that successfully authorizes the card.
  • SINGLE_USE - Card will close shortly after the first transaction.
  • UNLOCKED - Card will authorize at any merchant. Creating these cards requires additional privileges.
cvvstring

Three digit cvv printed on the back of the card.

panstring

Primary Account Number (PAN) (i.e. the card number).

Example response

{
  "created": "2021-06-28T22:53:15Z",
  "exp_month": "06",
  "exp_year": "2027",
  "memo": "New Card",
  "spend_limit": 1000,
  "token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
  "cvv": "776",
  "pan": "4111111289144142"
}