Release notes for New Card PIN Management Endpoints 05/08/2025

🔓 Reveal Card PIN

Endpoint:
GET /cards/{cardId}/pin

Description:
Retrieves the personal identification number (PIN) of a specified card.

Path Parameters:

• cardId (UUID, required) – The unique identifier of the card.

Response Example:

{
  "workflow": {},
  "data": {
    "card": {
      "pin": "1234"
    }
  },
  "connect": {},
  "metadata": {}
}

🔓 Set Card PIN

Endpoint:
POST /cards/{cardId}/pin

Description:
Sets or updates the PIN for the specified card.

Path Parameters:

• cardId (UUID, required) — The unique identifier of the card.

Request Body:

• workflow.code (string, required) — The workflow code. Allowed value: client.direct
• data.card.pin (string, required) — The card pin number. It must be a 4 digit number

Response Example:

{
  "workflow": {
    "code": "client.direct"
  },
  "data": {
    "card": {
        "pin":"4321"
    }
  },
  "connect": {},
  "metadata": {}
}

{
    "workflow": {},
    "data": {
        "card": {
            "pin": "4321"
        }
    },
    "connect": {},
    "metadata": {}
}