PUT/api/v2/cards/{cardId}/pin

Update card PIN

**PIN Code Rules** 1. **Length** The PIN must be exactly 6 digits. 2. **No repeated digits** It must not contain any sequence of three identical digits. Not allowed: `111`, `222`, `999` 3. **No sequential digits** No three consecutive increasing or decreasing digits. Examples not allowed: `123`, `234`, `789`, `890`, `098`, `321`

Authentication

Send your API key in the x-api-key header on every request.

Parameters

Request parameters
Field	Type	Required	Description
userId (query)	unknown	No	User ID (mandatory)
cardId (path)	unknown	Yes	Card ID (mandatory)

Request body

application/json

Request body fields
Field	Type	Required	Description
Pin	string	Yes	PIN Code Rules 1. Length The PIN must be exactly 6 digits. 2. No repeated digits It must not contain any sequence of three identical digits. Not allowed: `111`, `222`, `999` 3. No sequential digits No three consecutive increasing or decreasing digits. Examples not allowed: `123`, `234`, `789`, `890`, `098`, `321`

Responses

200 — OK

Response 200 fields
Field	Type	Required	Description
Success	boolean	No
Message	string	No

400 — Bad Request

Response 400 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

401 — Unauthorized

Response 401 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

404 — Not Found

Response 404 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

500 — Internal Server Error

Response 500 fields
Field	Type	Required
Message	string	No
Code	string	No
Status	unknown	No
ValidationErrors	object	No
Details	string	No

Example request

curl -X PUT "https://{base_url}/api/v2/cards/{cardId}/pin" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Pin":"…"}'

This page is generated from the live OpenAPI specification and always matches the current API.