Change physical card password

Every physical card has a password to authorize transactions, and it can be updated when necessary.

To update the card password, the status must be Active or Temporary block. (To learn about status, check here)

Attention

For security reasons, be careful when updating a password, as it can impact card authorization.

Create rules to improve password authorization security, such as not using birth dates, repeated numbers (e.g., 3333).

Request

ENDPOINT

/wallet/WALLET_KEY/card/CARD_KEY/password

METHOD

PATCH

Path params

Field	Type	Description	Characters
WALLET_KEY *	string	Wallet identification key.	uuid
CARD_KEY *	string	Card identification key.	uuid

Request Body

{
    "pin": "2143"
}

Body params

Field	Type	Description	Characters
pin *	string	Card password to authorize a transaction.	4

Response

STATUS SUCCESS

200

Response Body

{
    "card_key": "05fd3654-1f5d-479d-ade5-64239fdf214d",
    "status": "active",
    "account_key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "program_key": "6b6ebaac-043b-4390-8d62-e8098ec901e9",
    "type": "virtual",
    "card_name": "ecommerce",
    "printed_name": "Aurora Catarina",
    "brand": "visa",
    "last_four_digits": "5695",
    "created_at": "2023-02-20T19:28:16Z",
    "updated_at": "2023-02-22T19:28:16Z",
    "cvv_rotation_interval_hours": 72
}

Errors

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"
}

Code	Status code	Description
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.