Card Token

card_token

• uuid: required

carrier

• object
  • If omitted, the previous carrier will be used.

carrier object

• product_id: string
  • Specifies the configuration (e.g. physical card art) that the card should be manufactured with, and only applies to cards of type PHYSICAL. This must be configured with Lithic before use.

shipping_address

• object
  • If omitted, the previous shipping address will be used.

shipping_address object

shipping_method

• string
  • enum
  • Shipping method for the card. Only applies to cards of type PHYSICAL.

Use of options besides STANDARD require additional permissions.

• STANDARD - USPS regular mail or similar international option, with no tracking
  • STANDARD_WITH_TRACKING - USPS regular mail or similar international option, with tracking
  • PRIORITY - USPS Priority, 1-3 day shipping, with tracking
  • EXPRESS - FedEx or UPS depending on card manufacturer, Express, 3-day shipping, with tracking
  • 2_DAY - FedEx or UPS depending on card manufacturer, 2-day shipping, with tracking
  • EXPEDITED - FedEx or UPS depending on card manufacturer, Standard Overnight or similar international option, with tracking
  • BULK - Card will be shipped as part of a bulk fulfillment order. The shipping method and timeline are inherited from the parent bulk order.

Allowed: 2_DAY, BULK, EXPEDITED, EXPRESS, PRIORITY, STANDARD, STANDARD_WITH_TRACKING

200 OK

• object: Card details without PCI information
  • account_token: string - required
    • Globally unique identifier for the account to which the card belongs.
  • auth_rule_tokens: array of strings - deprecated
    • List of identifiers for the Auth Rule(s) that are applied on the card. This field is deprecated and will no longer be populated in the Card object. The key will be removed from the schema in a future release. Use the /auth_rules endpoints to fetch Auth Rule information instead.
  • card_program_token: string - required
    • Globally unique identifier for the card program on which the card exists.
  • bulk_order_token: uuid | null
    • Globally unique identifier for the bulk order associated with this card. Only applicable to physical cards that are part of a bulk shipment.
  • replacement_for: string | null
    • If the card is a replacement for another card, the globally unique identifier for the card that was replaced.
  • cardholder_currency: string
    • 3-character alphabetic ISO 4217 code for the currency of the cardholder.
  • created: date-time - required
    • An RFC 3339 timestamp for when the card was created. UTC time zone.
  • digital_card_art_token: string | null
    • Specifies the digital card art to be displayed in the user's digital wallet after tokenization. This artwork must be approved by Mastercard and configured by Lithic to use.
  • exp_month: string
    • Two digit (MM) expiry month.
  • exp_year: string
    • Four digit (yyyy) expiry year.
  • funding: nullfunding_account - required
    • Deprecated: Funding account for the card.
  • hostname: string
    • Hostname of card's locked merchant (will be empty if not applicable).
  • last_four: string - required
    • Last four digits of the card number.
  • memo: string
    • Friendly name to identify the card.
  • network_program_token: string | null
    • Globally unique identifier for the card's network program. Null if the card is not associated with a network program. Currently applicable to Visa cards participating in Account Level Management only.
  • pending_commands: array of strings
    • Indicates if there are offline PIN changes pending card interaction with an offline PIN terminal. Possible commands are: CHANGE_PIN, UNBLOCK_PIN. Applicable only to cards issued in markets supporting offline PINs.
  • pin_status: string
    • enum - required
    • Indicates if a card is blocked due a PIN status issue (e.g. excessive incorrect attempts).
    • OK, BLOCKED, NOT_SET
  • product_id: string | null
    • Only applicable to cards of type PHYSICAL. This must be configured with Lithic before use. Specifies the configuration (i.e., physical card art) that the card should be manufactured with.
  • spend_limit: integer - required
    • Amount (in cents) to limit approved authorizations (e.g. 100000 would be a $1,000 limit). Transaction requests above the spend limit will be declined.
  • spend_limit_duration: string
    • enum - required
    • Spend limit duration values:
      • ANNUALLY - Card will authorize transactions up to spend limit for the trailing 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. To support recurring monthly payments, which can occur on different day every month, the time window we consider for monthly velocity starts 6 days after the current calendar date one month prior.
      • TRANSACTION - Card will authorize multiple transactions if each individual transaction is under the spend limit. ANNUALLY, FOREVER, MONTHLY, TRANSACTION
  • state: string

    • enum - 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.
      • PENDING_FULFILLMENT - The initial state for cards of type PHYSICAL. The card is provisioned pending manufacturing and fulfillment. Cards in this state can accept authorizations for e-commerce purchases, but not for "Card Present" purchases where the physical card itself is present.
      • PENDING_ACTIVATION - At regular intervals, cards of type PHYSICAL in state PENDING_FULFILLMENT are sent to the card production warehouse and updated to state PENDING_ACTIVATION. Similar to PENDING_FULFILLMENT, cards in this state can be used for e-commerce transactions or can be added to mobile wallets. API clients should update the card's state to OPEN only after the cardholder confirms receipt of the card.
      • PENDING_ACTIVATION

      CLOSED, OPEN, PAUSED, PENDING_ACTIVATION, PENDING_FULFILLMENT

  • substatus: string | null
    • enum
    • Card state substatus values:
      • LOST - The physical card is no longer in the cardholder's possession due to being lost or never received by the cardholder.
      • COMPROMISED - Card information has been exposed, potentially leading to unauthorized access.
      • DAMAGED - The physical card is not functioning properly.
      • END_USER_REQUEST - The cardholder requested the closure of the card for reasons unrelated to fraud or damage.
      • ISSUER_REQUEST - The issuer closed the card for reasons unrelated to fraud or damage.
      • NOT_ACTIVE - The card hasn’t had any transaction activity for a specified period.
      • SUSPICIOUS_ACTIVITY - The card has one or more suspicious transactions or activities that require review.
      • INTERNAL_REVIEW - The card is temporarily paused pending further internal review.
      • EXPIRED - The card has expired and has been closed without being reissued.
      • UNDELIVERABLE - The card cannot be delivered to the cardholder and has been returned.
      • OTHER - The reason for the status does not fall into any of the above categories.

LOST, COMPROMISED, DAMAGED, END_USER_REQUEST, ISSUER_REQUEST, NOT_ACTIVE, SUSPICIOUS_ACTIVITY, INTERNAL_REVIEW, EXPIRED, UNDELIVERABLE, OTHER

• comment: string
  • Additional context or information related to the card.
• token: string - required
  • Globally unique identifier.
• type: string
  • enum - required
  • Card types:
    • VIRTUAL - Card will authorize at any merchant and can be added to a digital wallet.
    • PHYSICAL - Manufactured and sent to the cardholder.
    • SINGLE_USE - Card is closed upon first successful authorization.
    • MERCHANT_LOCKED - Card is locked to the first merchant that successfully authorizes the card.
    • UNLOCKED - [Deprecated] Similar behavior to VIRTUAL cards, please use VIRTUAL instead.
    • DIGITAL_WALLET - [Deprecated] Similar behavior to VIRTUAL cards, please use VIRTUAL instead.

MERCHANT_LOCKED, PHYSICAL, SINGLE_USE, VIRTUAL, UNLOCKED, DIGITAL_WALLET

• pan: string
  • length between 16 and 16 - Primary Account Number (PAN) (i.e. the card number).
• cvv: string
  • length between 3 and 3 - Three digit cvv printed on the back of the card.

HTTP Responses

400

A parameter in the query given in the request does not match the valid queries for the endpoint.

401

| User has not been authenticated | Invalid or missing API key | API key is not active | The API key used is no longer active | Could not find API key | The API key provided is not associated with any user | Please provide API key in Authorization header | The Authorization header is not in the request | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | Insufficient privileges. Issuing API key required | Insufficient privileges to create virtual cards.

404

The specified resource was not found.

422

Unprocessable entity.

429

Client has exceeded the number of allowed requests in a given time period.