---
title: "Editar cartão"
method: PUT
path: "/customers/{customer_id}/cards/{card_id}"
---

# Editar cartão

`PUT /customers/{customer_id}/cards/{card_id}`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/customers/{customer_id}/cards/{card_id}`
- Auth: HTTP basic

Com o verbo _HTTP PUT_, através do identificador do cartão (`card_id`) e do identificador do cliente ao qual o mesmo está associado (`customer_id`) é possível alterar dados do cartão informado.

## Path parameters

- `customer_id` string, required
- `card_id` string, required

## Request body

- object
  - `holder_name` string: 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.
  - `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.
  - `metadata` object: Objeto chave/valor utilizado para armazenar informações adicionais sobre o cartão. [Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata)

## Response `200`

200

- object
  - `id` string
  - `first_six_digits` string
  - `last_four_digits` string
  - `brand` string
  - `holder_name` string
  - `exp_month` integer
  - `exp_year` integer
  - `status` 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

## Other responses

- `404`: 404
- `422`: 422

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)