increase-test
PATCH/cards/{card_id}

Update a card

Updates one or more configurable properties of a Card. Supply only the fields you want to change; the request can update authorization controls, billing address, description, digital wallet contact details, Entity, or status. Status must be active, disabled, or canceled.

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

1 parameter · 6 body fields
card_idstringrequired
The identifier of the Card to update.

Fields to update on the Card. Supply only the properties you want to change.

authorization_controlsobjectoptional
Controls that restrict how this card can be used.
billing_addressobjectoptional
The card's updated billing address.
descriptionstringoptional
The description you choose to give the card.
digital_walletobjectoptional
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
entity_idstringoptional
The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.
statusstringoptional
The status to update the Card with.
Allowed:activedisabledcanceled

3 status codes
200Returns the updated Card object, including its identifier, current status, billing address, and configured controls.
account_idstringrequired
The identifier for the account this card belongs to.
authorization_controlsobjectrequired
Controls that restrict how this card can be used.
billing_addressobjectrequired
The Card's billing address.
binstringrequired
The Bank Identification Number (BIN) of the Card.
cardholder_nameobjectrequired
The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created.
descriptionstringrequired
The card's description for display purposes.
digital_walletobjectrequired
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
entity_idstringrequired
The identifier for the entity associated with this card.
expiration_monthintegerrequired
The month the card expires in M format (e.g., August is 8).
expiration_yearintegerrequired
The year the card expires in YYYY format (e.g., 2025).
idstringrequired
The 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).
last4stringrequired
The last 4 digits of the Card's Primary Account Number.
statusstringrequired
This indicates if payments can be made with the card.
Allowed:activedisabledcanceled
typestringrequired
A constant representing the object's type. For this resource it will always be `card`.
Allowed:card
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the server encounters an error processing the request.

Error handling

The card_id path parameter must identify the Card to update. status must be active, disabled, or canceled, and description must contain 1 to 200 characters. If supplied, billing_address must include line1, city, state, and postal_code; digital_wallet must include at least one field, and its email must use a valid email format.