QuickBooks: Create a charge — request body — body card

API reference · Contract 2026-10-20

SDK schema: Create a charge — request body — body card

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: allowed
address	Model	Optional	Expand Create a card — request body — body address The cardholder’s full address.
cardType	string	Optional	The type of credit or debit card. Valid values: VISA MC AMEX DISC DINERS JCB Conditionally required
commercialCardCode	string	Optional	A code that indicates if the card is a commercial or corporate card. This can be used to track specific business purchases. Maximum length: 25
created	string	Optional	The time the object was originally created. In ISO 8601 date-time format. It appears as YYYY-MM-DDTHH:MM:SSZ . Read only: true
cvc	string	Required within parent	The Card Verification Code (CVC) on the back of the card. This can be up to four digits. The number varies by card provider. For security purposes, the CVC value can’t be stored. It must be supplied in transaction requests and then erased.
default	JSON	Optional	Indicates if the credit or debit card is the default. When users set a default, the flag is true . This is the credit or debit card QuickBooks uses when another isn’t specified. The flag defaults to false . When a credit or debit card flag is true, all other cards are automatically set to false.
default (anyOf 1)	boolean	Alternative
default (anyOf 2)	string	Alternative	One of: true, false
expMonth	string	Required within parent	The card’s two digit expiration month.
expYear	string	Required within parent	The card’s four digit expiration year.
id	string	Optional	The unique identifier for the card object. Conditionally required
isBusiness	JSON	Optional	This flag is set to true if the credit or debit card is a business card.
isBusiness (anyOf 1)	boolean	Alternative
isBusiness (anyOf 2)	string	Alternative	One of: true, false
isLevel3Eligible	JSON	Optional	Flag set to true if the credit or debit card falls into the L3 eligible Bank Identification Number (BIN) range.
isLevel3Eligible (anyOf 1)	boolean	Alternative
isLevel3Eligible (anyOf 2)	string	Alternative	One of: true, false
name	string	Optional	The name of the credit or debit card holder, as it appears on the card. Maximum length: 30
number	string	Required within parent	The credit or debit card number.
updated	string	Optional	The time the object was last updated. In ISO 8601 date-time format. It appears as YYYY-MM-DDTHH:MM:SSZ . Conditionally required Read only: true
entityId	string	Optional	The ID of the entity the card is associated with.
entityType	string	Optional	The entity or user type the card is associated with. Example values: Customer , Employee , Vendor or Company .
zeroDollarVerification	Model	Optional	Expand Create a card — response body — zero Dollar Verification Stores card verification information.

Referenced models: Create a card — response body — zero Dollar Verification, Create a card — request body — body address