Sign in

v1

latestOpenAPI 3.0.02026-07-248834.9 KB
Card

Share card

Share a card securely with another person via email. The recipient will receive an email with a secure link to view the card details (PAN, CVV, expiration date). The shared card link expires after a set period for security. This feature requires a subscription.

post/cards/{card_token}/share

Path parameters

card_tokenstring uuid required

The unique token of the card to share.

Request body

recipient_emailstring email required

Email address of the recipient who will receive the shared card details.

theme'DEFAULT' | 'PRIVACY' | 'CONFETTI'

Optional visual theme for the shared card page. Defaults to DEFAULT if not specified.

Example request

{
  "recipient_email": "recipient@example.com"
}

Response

OK - Card successfully shared. Returns the card object.

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"
}