---
title: "Create vaulted card account"
method: POST
path: "/v3/customercardaccount"
---

# Create vaulted card account

`POST /v3/customercardaccount`

Store a customer's credit card on file

## Query parameters

- `id` integer, required
- `echo` boolean

## Request body

- object
  - `code` string — Account Code (Default is card)
  - `number` string — Card Number
  - `magstripe` string — Magstripe data; you would send in this field instead of number and expiry fields
  - `expiryMonth` string — Card expiration month
  - `expiryYear` string — Card expiration year
  - `avsZip` string — Billing zip code
  - `avsStreet` string — Billing street address
  - `cvv` string — Card verification value
  - `name` string — Cardholder's name
  - `isDefault` boolean — Is this card the primary card?
  - `alias` string — Add an additional identifier to your `customerCardAccount` object

## Response `201`

201

- object
  - `isDefault` boolean
  - `id` integer
  - `created` string
  - `alias` string
  - `cardType` string
  - `last4` string
  - `cardId` string
  - `token` string
  - `expiryMonth` string
  - `expiryYear` string
  - `name` string
  - `avsStreet` string
  - `avsZip` string
  - `hasContract` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)