---
title: "Alteração do status do cartão"
method: PATCH
path: "/cards/{proxy}/status"
tags: ["Gestão do status"]
---

# Alteração do status do cartão

`PATCH /cards/{proxy}/status`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/status`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Realize a alteração do <i>status</i> do cartão. O <i>status</i> escolhido poderá ser [temporário ou definitivo](/docs/tabela-possiveis-status-cartao).</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: card.update</span>
</div>
[block:callout]
{
  "type": "warning",
  "title": "Importante",
  "body": "É possível cancelar um cartão por meio da alteração do seu <i>status</i>."
}
[/block]

## Path parameters

- `proxy` string, required

## Headers

- `api-version` string, required: Versão da API. Atualmente estamos na versão 1.0.
- `Authorization` string, required: <em>Token</em> de autorização do tipo Bearer.

## Request body

- ChangeCardStatusRequest
  - `status` 'Active' | 'TemporarilyUserLocked' | 'CanceledByCustomer' | 'CanceledByEmitter' | 'DeathCanceled' | 'LostOrTheftCanceled' | 'CardDamagedCanceled' | 'CardBrokenCanceled' | 'CardWithDefectCanceled' | 'RobbedCanceled', required: Para compreender o que representa cada <i>status</i>, consulte a documentação [Possíveis status do cartão](/docs/tabela-possiveis-status-cartao).
  - `password` string, required: Senha de uso do cartão (4 dígitos). Este campo somente é <b>obrigatório</b> caso seja informado o _status_ "CanceledByEmitter" ou "DeathCanceled".
  - `updateCardBinded` boolean, required: Indica se os cartões vinculados devem ser atualizados.

## Response `200`

O <i>status</i> foi alterado com sucesso.

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)
- `404` (unresolved $ref)
- `406` (unresolved $ref)
- `409` (unresolved $ref)
- `500` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-cart-es.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-cart-es/revisions/1116211d65a0?raw)