Unblock Card

POST/cards/{serial}/unblockOpen in the API playground →

Info

Unblocking restores full transaction capability to a previously blocked card.

Request

Authorizationstringheaderrequired

Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

serialstringpathrequired

Card serial number (e.g., OLIV0001)

Body Parameters

pinstringbody

Subscriber's PIN (required for self-service unblock)

---

Response

successboolean

Whether unblock succeeded

messagestring

Result message

---

Examples

Request

cURL

curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/unblock" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'

Response

200 Success

{
  "success": true,
  "message": "Card unblocked successfully",
  "card": {
    "serial": "OLIV0001",
    "status": "ACTIVE",
    "unblocked_at": "2025-01-20T15:30:00Z",
    "unblocked_by": "admin@smartpay.sl"
  }
}

409 Not Blocked

{
  "error": "Card is not blocked",
  "code": "NOT_BLOCKED"
}

---

What Gets Restored

Status Updated

Card status changes from BLOCKED to ACTIVE

Transactions Enabled

POS payments and NFC tap work again

PIN Active

Original PIN remains unchanged

---

Restrictions

Warning

Cards blocked as "Lost" or "Stolen" cannot be unblocked. Issue a new card instead.

---

Errors

Status	Code	Description
400	INVALID_PIN	PIN verification failed
400	PERMANENT_BLOCK	Card cannot be unblocked (lost/stolen)
401	UNAUTHORIZED	Invalid API key
404	CARD_NOT_FOUND	Card serial not found
409	NOT_BLOCKED	Card is not blocked
500	INTERNAL_ERROR	Server error

---

Related

Block Card

Block a card from transactions