---
title: "Create customer card"
method: POST
path: "/customers/{customer_id}/cards"
tags: ["Customers"]
---

# Create customer card

`POST /customers/{customer_id}/cards`

Add new customer card. When a new card is added, Vrio will attempt an authorization on merchants for pending transactions to tokenize the card for recurring transactions.

## Request body

- object
  - `card_type_id` integer, required — Required when passing payment method ID = 1 and when not passing a customer card ID. * `1` - Mastercard * `2` - Visa * `3` - Discover * `4` - American Express * `5` - Digital Wallet * `6` - ACH
  - `card_number` string, required — Full Card Number.
  - `card_exp_month` integer, required — Card Expiration month (08).
  - `card_exp_year` integer, required — Card Expiration year (2018).
  - `card_cvv` string, required — Card Security Card.
  - `make_default` boolean — Pass as true to card the address on recurring and pending orders.
  - `orders` integer[] — Pass an array of order ids to update.
  - `customers_address_billing_id` integer — Pass a billing address to associate with that card.

## Response `200`

OK

- object
  - `customer_card_id` integer
  - `card_type_id` null | 1 | 2 | 3 | 4 | 5 | 6 | 7, nullable — * `1` - Mastercard * `2` - Visa * `3` - Discover * `4` - American Express * `5` - Digital Wallet * `6` - ACH * `7` - SEPA
  - `card_number` string
  - `card_exp_month` integer
  - `card_exp_year` integer
  - `card_prepaid` boolean
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `created_by` integer
  - `modified_by` integer

## Other responses

- `400` — Error response
- `401` — Unauthorized response
- `403` — Forbidden response
- `500` — Error response

---

[API](https://skmtc.net/vrio/apis/crm-configuration.md) · [All operations](https://skmtc.net/vrio/apis/crm-configuration/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vrio/crm-configuration/revisions/62037010356e/schema)