Get PIN for a physical card

Retrieves the PIN of the physical card identified by the id path parameter, for the cardholder to use at point of sale and at ATMs.

Prerequisites

The card must be physical and already activated. See Activate a physical card. Calling this before activation fails with PHYSICAL_CARD_NOT_ACTIVATED.

This operation requires a stepped-up access token. Step up before calling it by issuing a challenge through Step-up.

Handling the response

Unless you are PCI-DSS compliant and have opted out of Weavr's security model, the PIN comes back tokenized rather than in plain text. Pass the token to the Display Card PIN UI Component embedded in your application, which renders the PIN on screen. Don't log it, store it, or send it anywhere else.

Conflicts

PIN_NOT_SET means no PIN has been assigned to the card yet. PIN_TRIES_EXCEEDED means the PIN is blocked after too many failed attempts. Clear it with Unblock PIN before retrying.