Skip to main content
POST
/
api
/
v1
/
cards
/
{serial}
/
unblock
curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/cards/OLIV0001/unblock" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'
{
  "success": true,
  "message": "Card unblocked successfully",
  "card": {
    "serial": "OLIV0001",
    "status": "ACTIVE",
    "unblocked_at": "2025-01-20T15:30:00Z",
    "unblocked_by": "admin@olive.sl"
  }
}
Unblocking restores full transaction capability to a previously blocked card.

Request

Authorization
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

Path Parameters

serial
string
required
Card serial number (e.g., OLIV0001)

Body Parameters

pin
string
Subscriber’s PIN (required for self-service unblock)

Response

success
boolean
Whether unblock succeeded
message
string
Result message

Examples

curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/cards/OLIV0001/unblock" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "pin": "1234"
  }'
{
  "success": true,
  "message": "Card unblocked successfully",
  "card": {
    "serial": "OLIV0001",
    "status": "ACTIVE",
    "unblocked_at": "2025-01-20T15:30:00Z",
    "unblocked_by": "admin@olive.sl"
  }
}

What Gets Restored

1

Status Updated

Card status changes from BLOCKED to ACTIVE
2

Transactions Enabled

POS payments and NFC tap work again
3

PIN Active

Original PIN remains unchanged

Restrictions

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

Errors

StatusCodeDescription
400INVALID_PINPIN verification failed
400PERMANENT_BLOCKCard cannot be unblocked (lost/stolen)
401UNAUTHORIZEDInvalid API key
404CARD_NOT_FOUNDCard serial not found
409NOT_BLOCKEDCard is not blocked
500INTERNAL_ERRORServer error

Block Card

Block a card from transactions