increase-test
POST/physical_cards

Create a physical card

Creates a physical card for an underlying card and specifies the cardholder and shipping details. Supply card_id, both cardholder names, and the required shipment method and address; if omitted, the physical card profile defaults to the latest default profile.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

4 body fields

Physical card details, including the underlying card, cardholder name, and shipment information.

card_idstringrequired
The underlying card representing this physical card.
cardholderobjectrequired
Details about the cardholder, as it will appear on the physical card. The combined first name and last name cannot exceed 25 characters.
physical_card_profile_idstringoptional
The physical card profile to use for this physical card. The latest default physical card profile will be used if not provided.
shipmentobjectrequired
The details used to ship this physical card.

3 status codes
200Returns the created physical card, including its identifier, account and card identifiers, cardholder details, status, and shipment information.
account_idstringrequired
The identifier for the Account this Physical Card belongs to.
card_idstringrequired
The identifier for the Card this Physical Card represents.
cardholderobjectrequired
Details about the cardholder, as it appears on the printed card.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Physical Card was created.
idstringrequired
The physical card identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
physical_card_profile_idstringrequired
The Physical Card Profile used for this Physical Card.
shipmentobjectrequired
The details used to ship this physical card.
statusstringrequired
The status of the Physical Card.
Allowed:activedisabledcanceled
typestringrequired
A constant representing the object's type. For this resource it will always be `physical_card`.
Allowed:physical_card
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the service encounters an internal error.

Error handling

card_id, cardholder, and shipment are required; cardholder must include first_name and last_name, and shipment must include method and address. The combined cardholder first and last names cannot exceed 25 characters, and each name must match the specified character pattern. shipment.method must be usps, fedex_priority_overnight, fedex_2_day, or dhl_worldwide_express; the address must include name, line1, city, state, and postal_code.