Alterar senha cartão físico

Todo cartão físico tem uma senha para autorizar a transação, e ela pode ser atualizada caso necessária.

Para atualizar a senha do cartão o status tem que ter o tipo Active ou Temporary block.(Para conhecer sobre status consulte aqui)

Atenção

Por motivos de segurança, cuidado ao atualizar uma senha, pois ela pode impactar na autorização de um cartão.

Crie regras para melhorar a segurança da autorização da senha, como não utilizar data de aniversário, números repetidos (ex: 3333).

Request

ENDPOINT

/prepaid/card/CARD_KEY/password

MÉTODO

PATCH

Path params

Campo	Tipo	Descrição	Caracteres
CARD_KEY *	string	Chave de identificação do cartão.	uuid

Request Body

{
    "pin": "2143"
}

Body params

Campo	Tipo	Descrição	Caracteres
pin *	string	Senha do cartão para autorizar uma transação.	4

Response

STATUS SUCCESS

200

Erros

STATUS

4XX

Response Body

{
  "title": "Bad Request",
  "description": "We're sorry, but the card could not be update password. Please try again later.",
  "translation": "Unexpected error update password card",
  "code": "CARD000024"
}

Código	Status code	Descrição
QIT000001	400	Invalid Json schema.
CARD000011	404	It was not possible to fetch the Card for the card_key {card_key}.
CARD000023	406	The card type is invalid for this operation. Only plastic cards are allowed.
CARD000024	400	We're sorry, but the card could not be update password. Please try again later.
CARD000025	406	The status {status} is invalid for the operation.

Webhook

WEBHOOK_TYPE

baas.prepaid_card.card.updated.password

Webhook Body

{
    "webhook_type": "baas.prepaid_card.card.updated.password",
    "event_datetime": "2023-07-25T12:00:00.000Z",
    "data": {
        "card_key": "9bd93e97-bb6d-410f-8981-06b2765f12a1"
    }
}