Cards

Unblock a card PIN

Changed on

Clear a BLOCKED PIN, restoring the cardholder's existing PIN without changing it. A PIN blocks after three consecutive incorrect entries; until it is cleared, PIN-verified transactions decline.

Unblocking is idempotent and safe to call on a card whose pinStatus is already OK. It has no effect on a card with no PIN set, which returns 409 — set a PIN with POST /cards/{id}/set-pin instead.

Each card permits one unblock attempt per rolling seven days. Further attempts return 409 PIN_CHANGE_REQUIRED with details.pinUnblockAvailableAt. Change the PIN through either PIN-entry flow to recover sooner; changing the PIN does not reset the unblock allowance.

Only request an unblock after authenticating the cardholder and receiving their explicit request. Do not automatically unblock after a declined transaction.

Grid supports online PINs only. Offline PIN cards are not supported. Read GET /cards/{id} to check pinStatus.

Every call is audit-logged with the requesting actor.

post/cards/{id}/pin/unblock

Request

  • Base URL
    https://api.lightspark.com/grid/2025-10-13
  • URL
    https://api.lightspark.com/grid/2025-10-13/cards/{id}/pin/unblock
  • Auth
    HTTP basic

Response

PIN unblock accepted; read GET /cards/{id} for its pinStatus.

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • warning

      added the new CORRIDOR_UNDER_MAINTENANCE enum value to the response property for the response status