Card PIN Management

Set/Update a PIN for a card

Set PIN

Sets a PIN for a card (first-time setup).

Endpoint: POST /{san}/set-pin

Path Parameters:

• san - Secure Account Number (card identifier)

Content-Type: application/json

Request Body:

{
  "pin": "1234"
}

Request Parameters:

Field	Type	Required	Constraints	Description
pin	String	Yes	Exactly 4 digits	New PIN code

Response:

{
  "success": true,
  "message": "PIN set successfully"
}

---

Update PIN

Updates an existing card PIN.

Endpoint: POST /{san}/update-pin

Path Parameters:

• san - Secure Account Number (card identifier)

Content-Type: application/json

Request Body:

{
  "oldPin": "1234",
  "pin": "5678"
}

Request Parameters:

Field	Type	Required	Constraints	Description
oldPin	String	Yes (for some products only)	Exactly 4 digits	Current PIN code
pin	String	Yes	Exactly 4 digits	New PIN code

Response:

{
  "success": true,
  "message": "PIN updated successfully"
}

---

Response Parameters:

Field	Type	Description
success	Boolean	Indicates if the operation was successful
message	String	Descriptive message about the operation result