BAbankly
Gestão do status

Alteração do status do cartão

<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]
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

Path parameters

proxystring required

Código identificador do cartão.

Headers

api-versionstring required

Versão da API. Atualmente estamos na versão 1.0.

Authorizationstring required

<em>Token</em> de autorização do tipo Bearer.

Request body

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.

passwordstring 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".

updateCardBindedboolean required

Indica se os cartões vinculados devem ser atualizados.

Response

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

Changes

No recorded changes to this operation across all 1 revision of this API.