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 — Unique card identifier in the CinCin system

Request

Content-Type: application/json

Request Body

Request (application/json)

{
  "pin": "1234"
}

Request parameters

• *pin (string, 4 digits) — New initial card PIN code

Response

Response (application/json)

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

---

Update PIN

Updates an existing card PIN.

Endpoint

POST /{san}/update-pin

Path Parameters

• san — Unique card identifier in the CinCin system

Request

Content-Type: application/json

Request body

Request (application/json)

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

Request parameters

• *oldPin (string, 4 digits) — Actual PIN code

• *pin (string, 4 digits) — New PIN code

Response

Response (application/json)

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