Sign in

v1

latestOpenAPI 3.0.22026-07-26128245430.3 KB
Cards

Update a card account

Update a card account. Supports changing the settlement currency or closing a card account by setting the status to "inactive". Closing permanently cancels all associated cards and is irreversible.

put/customers/{customerID}/card_accounts/{cardAccountID}

Request body

currencystring

The new settlement currency for the card account.

status'inactive'

The desired status for the card account. Currently only "inactive" is supported.

Response

The updated card account

idstring required

A UUID that uniquely identifies a resource

client_reference_idstring

The client-provided reference ID

customer_idstring required

A UUID that uniquely identifies a resource

card_image_urlstring

An expiring URL used to render the card image, with a validity period of 5 minutes. Note: This field will be deprecated in favor of the more secure and scalable card details API. Please see the integration guide on safely revealing card details for more information.

status'active' | 'pending' | 'inactive' | 'frozen' required

Status of the card account

status_reasonstring

An optional detailed explanation for the card account status

stripe_card_idstring nullable

The Stripe Issuing card ID, if the card account is backed by Stripe Issuing

Example response

{
  "card_details": {
    "last_4": "1264",
    "expiry": "10/24",
    "bin": "44325280"
  }
}