Skip to main content
POST
Unblocking restores full transaction capability to a previously blocked card.

Request

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

Path Parameters

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

Body Parameters

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

Response

boolean
Whether unblock succeeded
string
Result message

Examples


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


Block Card

Block a card from transactions

Authorizations

Authorization
string
header
required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Path Parameters

serial
string
required

Card Serial Number

Body

application/json

PIN for non-admin users

pin
string
Example:

"1234"

Response

Card unblocked

The response is of type object.