Replace a card
Issues a new card with the same customer, program and controls.
Authorizations
Secret API key, e.g. sk_live_... or sk_test_....
Headers
Unique key that makes the request safe to retry. Keys expire after 24 hours.
255Path Parameters
Body
lost, stolen, damaged, expired, other Defaults to the type of the existing card.
virtual, physical Terminate the existing card once the replacement is created. Always true for lost and stolen.
Response
Created.
A virtual or physical payment card. Full card number and CVC are never returned by this API.
Unique identifier, prefixed with card_.
"card_01JZ8N2K4M"
Object type.
card "cus_01JZ8M4X7K"
"prog_01JZ8A2K4M"
virtual, physical pending until the card is ready for use. terminated is final.
pending, active, frozen, terminated Three-letter ISO 4217 currency code.
^[A-Z]{3}$"EUR"
Time the card was created.
visa, mastercard ^[0-9]{4}$"4821"
Card-level spending limits. Omitted or null limits are not enforced.
ID of the card this card replaced, if any.
Up to 50 key-value pairs for your own reference. Values are strings up to 500 characters.
Time the card was last updated.