Unblock a card PIN
Changed onClear 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.
Request
- Base URLhttps://api.lightspark.com/grid/2025-10-13
- URLhttps://api.lightspark.com/grid/2025-10-13/cards/{id}/pin/unblock
- AuthHTTP 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
- info
- warning
added the new
CORRIDOR_UNDER_MAINTENANCEenum value to theresponse property for the response status
- warning