Sign in

v1

latestOpenAPI 3.0.22026-07-26128245430.3 KB
Cards

Provision a card account

Provision a card account. NOTE: the legacy Bridge Cards API is deprecated, and stablecoin card issuing capabilities are now natively integrated into Stripe Issuing. Please see this guide for more details on how to enable your account for Stripe Issuing.

post/customers/{customerID}/card_accounts

Path parameters

customerIDstring required

A UUID that uniquely identifies a resource

Headers

Idempotency-Keystring required

Request body

client_reference_idstring

An optional client-provided reference ID that uniquely identifies the card account in the client's system

currency'usdc' required
chain'arbitrum' | 'avalanche_c_chain' | 'base' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'stellar' required
card_design_shortnamestring

The shortname of the card design to use for the card account. If not specified, the default card design will be used.

Response

The successfully created 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"
  }
}