---
title: "Criar cartão"
method: POST
path: "/customers/{customer_id}/cards"
---

# Criar cartão

`POST /customers/{customer_id}/cards`

Este recurso cria um `card` associado ao `customer` através do `customer_id` informado.

## Path parameters

- `customer_id` string, required

## Request body

- object
  - `number` string, required — Número do cartão. Entre 13 e 19 caracteres
  - `holder_name` string, required — Nome do portador como está impresso no cartão. Máximo de 64 caracteres (Caracteres especiais e números não são aceitos)
  - `holder_document` string — CPF ou CNPJ do portador do cartão. Obrigatório caso o tipo do cartão seja voucher (bandeiras **VR** ou **Pluxee**).
  - `exp_month` integer, required — Mês de validade do cartão. Valor entre 1 e 12 (inclusive)
  - `exp_year` integer, required — Ano de validade do cartão. Formatos **yy** ou **yyyy**. Ex: 23 ou 2023.
  - `cvv` string, required — Código de segurança do cartão. O campo aceita 4 ou 3 caracteres, variando por bandeira.
  - `brand` string — Bandeira do cartão. Para cartões de crédito, temos como valores possíveis: **elo**, **mastercard**, **visa**, **amex**, **jcb**, **aura**, **hipercard**, **diners**, **unionpay** ou **discover**.
  - `label` string — Indica a label do cartão
  - `billing_address_id` string — Código do endereço de cobrança. Max: 36 caracteres.<>**Opcional**, pode ser utilizado no lugar do `billing_address`.
  - `billing_address` object — Endereço de cobrança.
    - `line_1` string — Linha 1 do endereço. (Número, Rua, e Bairro - Nesta ordem e separados por vírgula) Max: 256 caracteres.
    - `line_2` string — Linha 2 do endereço. (Complemento - Andar, Sala, Apto). Max: 128 caracteres.
    - `zip_code` string — CEP. Max: 16 caracteres.
    - `city` string — Cidade. Max: 64 caracteres.
    - `state` string — Código do estado no formato ISO 3166-2.
    - `country` string — Código do país no formato ISO 3166-1 alpha-2.
  - `options` object — Objeto com opções para a criação do cartão. Um exemplo de opção que pode ser adicionada ao cartão é o `verify_card` : `true`, que informa que haverá uma validação do cartão antes da utilização (Zero Dollar Auth).
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o cartão. [Saiba mais sobre metadata](https://docs.pagar.me/reference/metadata-1)
  - `token` string — Pode ser enviado no lugar dos dados do cartão, caso este já tenha sido tokenizado previamente. [Saiba mais sobre criação de token de cartão.](https://docs.pagar.me/reference/criar-token-cart%C3%A3o-1)

## Response `200`

200

- union
  - object
    - `id` string
    - `first_six_digits` string
    - `last_four_digits` string
    - `brand` string
    - `holder_name` string
    - `holder_document` string
    - `exp_month` integer
    - `exp_year` integer
    - `status` string
    - `label` string
    - `created_at` string
    - `updated_at` string
    - `billing_address` object
      - `zip_code` string
      - `city` string
      - `state` string
      - `country` string
      - `line_1` string
      - `line_2` string
    - `customer` object
      - `id` string
      - `name` string
      - `email` string
      - `document` string
      - `type` string
      - `delinquent` boolean
      - `created_at` string
      - `updated_at` string
      - `phones` object
        - `home_phone` object
          - `country_code` string
          - `number` string
          - `area_code` string
        - `mobile_phone` object
          - `country_code` string
          - `number` string
          - `area_code` string
      - `metadata` object
        - `company` string
    - `type` string
  - object
    - `id` string
    - `first_six_digits` string
    - `last_four_digits` string
    - `brand` string
    - `holder_name` string
    - `holder_document` string
    - `exp_month` integer
    - `exp_year` integer
    - `status` string
    - `type` string
    - `created_at` string
    - `updated_at` string
    - `billing_address` object
      - `zip_code` string
      - `city` string
      - `state` string
      - `country` string
      - `line_1` string
      - `line_2` string
    - `network_token` object
      - `token_unique_reference` string
      - `status` string
    - `customer` object
      - `id` string
      - `name` string
      - `email` string
      - `code` string
      - `document` string
      - `document_type` string
      - `type` string
      - `gender` string
      - `delinquent` boolean
      - `created_at` string
      - `updated_at` string
      - `birthdate` string
      - `phones` object
        - `home_phone` object
          - `country_code` string
          - `number` string
          - `area_code` string
        - `mobile_phone` object
          - `country_code` string
          - `number` string
          - `area_code` string
      - `metadata` object
        - `company` string

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/revisions/dababf062743/schema)