Alteração do status do cartão

Permite ao cliente do parceiro (ou ao próprio parceiro, em casos como fraude ou inadimplência) alterar o status de um cartão. O cartão pode passar para um status temporário (reversível) ou definitivo (irreversível).

Pré-requisitos

• O cliente tem um cartão com status diferente de Building.

Veja a tabela completa de status para os valores aceitos.

Requisição (Request)

Requisição HTTP

PATCH https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/status

     --request PATCH \
     --url 'https://api-mtls.sandbox.bankly.com.br/cards/{proxy}/status' \
     --header 'Authorization: Bearer {{Token}}' \
     --header 'accept: application/json' \
     --header 'api-version: 1.0' \
     --header 'content-type: application/json' \
     --data '
{
     "status": "TemporarilyUserLocked",
     "password": "8457",
     "updateCardBinded": false
}'

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.
Esta requisição requer o scope descrito a seguir:

Cabeçalhos (Headers)

Parâmetros da rota (Path)

Corpo da requisição (Body)

Os seguintes status podem ser informados sem o campo password: Active, TemporarilyUserLocked, CanceledByCustomer, LostOrTheftCanceled, CardDamagedCanceled, CardBrokenCanceled, CardWithDefectCanceled, RobbedCanceled.

{
     "status": "TemporarilyUserLocked",
     "password": "8457",
     "updateCardBinded": false
}

Resposta

Status: 200 OK — status alterado com sucesso. Sem corpo de resposta.

Erros

Além dos erros comuns a todos os endpoints:

Eventos

Configure os webhooks para receber:

Artigos relacionados

• Possíveis status do cartão
• Ativação do cartão
• Consulta dos próximos status