Convert virtual to physical card

post

https://sandbox.lithic.com/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 Params

card_token

uuid

required

Body Params

carrier

object

If omitted, the previous carrier will be used.

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

required

The shipping address this card will be sent to.

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:

Responses


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	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

200OK

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

404The specified resource was not found.

422Unprocessable entity.