Change Card PIN

POST

/api/v1/cardoperations/{cardId}/pin/change

Changes the card's PIN by supplying the current (old) PIN along with the new one. Use this when the customer already knows their PIN; use pin/set instead to set or reset a PIN without the old value.

⚠️ Required Fields

Field	Type	Description	Constraints
`oldPin`	`string`	The customer's current PIN	Min: 4 · Max: 6
`newPin`	`string`	The new PIN — must differ from the current PIN	Min: 4 · Max: 6

📤 Response Fields

Field	Type	Description
`id`	`string (uuid)`	Card identifier
`pinChanged`	`boolean`	Whether the PIN was changed successfully
`updatedAt`	`string (date-time)`	Timestamp the PIN was updated

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

PIN changed successfully.

Bodyapplication/json

🟠401

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/cardoperations/6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f/pin/change' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;' \
--header 'Content-Type: application/json' \
--data '{
    "oldPin": "4821",
    "newPin": "7734"
}'

Response Example

200 - Success

{
    "id": "6f1c9a2e-4b3d-4e7a-9c5f-1a2b3c4d5e6f",
    "pinChanged": true,
    "updatedAt": "2026-01-15T11:25:00Z"
}

Modified at 2026-08-10 12:35:21

Set Card PIN

Update Card Limits