The Card object contains the credit or debit card information needed to process a payment.
Properties
| Field | Type | Required | Description |
|---|
number | string | ✅ | Card number (PAN), digits only |
holderName | string | ✅ | Name printed on the card |
cvv | string | ❌ | Card verification value (3-4 digits) |
expiryMonth | string | ✅ | Expiration month (01-12) |
expiryYear | string | ✅ | Expiration year (4 digits) |
brand | string | ❌ | Card brand (e.g., “VISA”, “MASTERCARD”, “AMEX”) |
Security Notes
Never store card details - Always use tokenization for recurring payments. Card data should only be used for immediate processing.
- Card numbers should be transmitted securely over HTTPS
- CVV should never be stored after processing
- Consider using our tokenization features for recurring payments
