Cards

Create card account

Create a new card account.

post/issuing/card-accounts

Request

  • Base URL: https://api.column.com
  • URL: https://api.column.com/issuing/card-accounts
  • Auth: HTTP basic

Headers

Idempotency-Keystring

Idempotency keys can be up to 255 characters long and are case sensitive. Column reserves the right to expire idempotency keys after 30 days. Only ASCII printable characters (code 32 - 126) are allowed for idempotency keys.

Request body

bank_account_idstring

Bank account to associate with the card account. This field is only accepted for debit programs. It must be omitted for credit-backed programs. For cardholder_secured programs, the collateral account is derived from the secured loan and cannot be overridden.

card_authorization_policy_idstring

Card authorization policy to associate with the card account

card_program_idstring required

The ID of the card program to create the card account under

loan_idstring

Loan to associate with the card account. For a cardholder_secured program, the loan must have type=secured.

Example request

{
  "bank_account_id": "bacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_authorization_policy_id": "caup_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "loan_id": "loan_2x8gszy5folpA9s0TOCseE9ABDM"
}

Response

Successful response

bank_account_idstring

The ID of the associated bank account, if any. For a cardholder_secured account, this is the secured loan's collateral bank account and is set automatically at creation.

card_program_idstring required

The ID of the card program

closed_atstring date-time nullable

The closed date of the card account

created_atstring date-time required

The creation date of the card account

idstring required

The ID of the card account

last_opened_atstring date-time nullable

The last opened date of the card account

last_suspended_atstring date-time nullable

The last suspended date of the card account

loan_idstring

The ID of the associated loan (if any)

statusstring required

The status of the card account

Example response

{
  "bank_account_id": "bacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "id": "cacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "loan_id": "loan_2x8gszy5folpA9s0TOCseE9ABDM",
  "status": "active"
}

Changes

No recorded changes to this operation across all 1 revision of this API.