Convert Physical

Convert virtual to physical card

post/v1/cards/{card_token}/convert_physical

Convert a virtual card into a physical card and manufacture it. Customer must supply relevant fields for physical card creation including product_id, carrier, shipping_method, and shipping_address. The card token will be unchanged. The card's type will be altered to PHYSICAL. The card will be set to state PENDING_FULFILLMENT and fulfilled at next fulfillment cycle. Virtual cards created on card programs which do not support physical cards cannot be converted. The card program cannot be changed as part of the conversion. Cards must be in an OPEN state to be converted. Only applies to cards of type VIRTUAL (or existing cards with deprecated types of DIGITAL_WALLET and UNLOCKED).

Path Parameters

card_tokenstring

formatuuid

Body Parameters

shipping_address

The shipping address this card will be sent to.

carrier

optional

If omitted, the previous carrier will be used.

product_idstring

optional

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_methodenum

optional

Accepts one of the following: "2_DAY", "EXPEDITED", "EXPRESS", 3 more

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

Hide ParametersShow Parameters

"2_DAY"

"EXPEDITED"

"EXPRESS"

"PRIORITY"

"STANDARD"

"STANDARD_WITH_TRACKING"

Returns

Request example Request

curl https://api.lithic.com/v1/cards/$CARD_TOKEN/convert_physical \
    -H 'Content-Type: application/json' \
    -H "Authorization: $LITHIC_API_KEY" \
    -d '{
      "shipping_address": {
        "address1": "5 Broad Street",
        "city": "NEW YORK",
        "country": "USA",
        "first_name": "Janet",
        "last_name": "Yellen",
        "postal_code": "10001",
        "state": "NY",
        "address2": "Unit 5A"
      }
    }'

200 Example

{
  "token": "7ef7d65c-9023-4da3-b113-3b8583fd7951",
  "account_token": "f3f4918c-dee9-464d-a819-4aa42901d624",
  "card_program_token": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "created": "2021-06-28T22:53:15Z",
  "funding": {
    "token": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "created": "2019-12-27T18:11:19.117Z",
    "last_four": "xxxx",
    "state": "DELETED",
    "type": "DEPOSITORY_CHECKING",
    "account_name": "account_name",
    "nickname": "x"
  },
  "last_four": "xxxx",
  "pin_status": "OK",
  "spend_limit": 1000,
  "spend_limit_duration": "ANNUALLY",
  "state": "CLOSED",
  "type": "MERCHANT_LOCKED",
  "auth_rule_tokens": [
    "string"
  ],
  "cardholder_currency": "USD",
  "digital_card_art_token": "00000000-0000-0000-1000-000000000000",
  "exp_month": "06",
  "exp_year": "2027",
  "hostname": "hostname",
  "memo": "New Card",
  "pending_commands": [
    "string"
  ],
  "product_id": "1",
  "replacement_for": "5e9483eb-8103-4e16-9794-2106111b2eca",
  "cvv": "776",
  "pan": "4111111289144142"
}