increase-test
POST/cards

Create a card

Creates a Card belonging to an Account. Supply the required account_id and optionally configure its billing address, cardholder, description, digital wallet contact details, Entity, and authorization controls. The response includes the created Card's identifier, status, expiration, and non-sensitive card details.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

7 body fields

Card details. account_id is required; billing address, cardholder name, description, digital wallet contact details, Entity, and authorization controls are optional.

account_idstringrequired
The Account the card should belong to.
authorization_controlsobjectoptional
Controls that restrict how this card can be used.
billing_addressobjectoptional
The card's billing address.
cardholder_nameobjectoptional
The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations.
descriptionstringoptional
The description you choose to give the card.
digital_walletobjectoptional
The contact information used in the two-factor steps for digital wallet card creation. To add the card to a digital wallet, you may supply an email or phone number with this request. Otherwise, subscribe and then action a Real Time Decision with the category `digital_wallet_token_requested` or `digital_wallet_authentication_requested`.
entity_idstringoptional
The Entity the card belongs to. You only need to supply this in rare situations when the card is not for the Account holder.

3 status codes
200Returns the created Card object, including its identifier, Account, status, expiration month and year, last four digits, billing address, and configured controls.
account_idstringrequired
The identifier for the account this card belongs to.
authorization_controlsobjectrequired
Controls that restrict how this card can be used.
billing_addressobjectrequired
The Card's billing address.
binstringrequired
The Bank Identification Number (BIN) of the Card.
cardholder_nameobjectrequired
The name of the cardholder. Used to respond to Account Name Inquiry requests from acquirers in Card Validations.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Card was created.
descriptionstringrequired
The card's description for display purposes.
digital_walletobjectrequired
The contact information used in the two-factor steps for digital wallet card creation. At least one field must be present to complete the digital wallet steps.
entity_idstringrequired
The identifier for the entity associated with this card.
expiration_monthintegerrequired
The month the card expires in M format (e.g., August is 8).
expiration_yearintegerrequired
The year the card expires in YYYY format (e.g., 2025).
idstringrequired
The card identifier.
idempotency_keystringrequired
The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
last4stringrequired
The last 4 digits of the Card's Primary Account Number.
statusstringrequired
This indicates if payments can be made with the card.
Allowed:activedisabledcanceled
typestringrequired
A constant representing the object's type. For this resource it will always be `card`.
Allowed:card
4XXReturned when the request is invalid or cannot be processed.
5XXReturned when the server encounters an error processing the request.

Error handling

account_id is required. If supplied, billing_address must include line1, city, state, and postal_code, and cardholder_name must include first and last; each supplied address or name value must meet its stated length limits. description must contain 1 to 200 characters, and digital_wallet.email must be a valid email address.