Lifecycle
- OPEN — Card is active and can be used for purchases
- CLOSED — Card is revoked and cannot be used. Any uncaptured PaymentIntent hold is cancelled to release funds back to the cardholder’s payment method.
Properties
| Field | Type | Description |
|---|---|---|
id | string | Unique card identifier |
cardholderId | string | Cardholder the card belongs to |
last4 | string | Last 4 digits of the card number |
expiry | string | Expiration date (MM/YY) |
spendLimitCents | integer | Original spend limit in cents |
balanceCents | integer | Remaining balance in cents |
status | string | OPEN or CLOSED |
createdAt | string | ISO 8601 timestamp |
Sensitive fields
The full card number (pan) and security code (cvv) are only returned by the Get Card Details endpoint. All other endpoints return only the last4.
Limits
- Maximum card amount: $500.00 (50,000 cents)
- Maximum active cards per user: 5
How card funding works
Every card belongs to a cardholder. When you create a card, a PaymentIntent hold is placed on the cardholder’s saved payment method for the card’s spend limit. The funds are authorized but not captured until the card is used. If the card is closed before the hold is captured, the hold is cancelled and the funds are released. This means:- The cardholder must have a payment method attached before cards can be created.
- The cardholder’s payment method must have sufficient funds to authorize the hold.
- Closing a card releases any uncaptured hold — funds are never moved to an intermediate wallet.