Skip to main content
POST
Blocking a card prevents all transactions. Use for lost cards, suspected fraud, or at customer request.

Request

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

Path Parameters

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

Body Parameters

string
required
Reason for blocking (logged for audit)
string
Subscriber’s PIN (required for self-service blocking)

Response

boolean
Whether block succeeded
string
Result message

Examples


Block Reasons


Effects

Transactions Blocked

  • POS payments rejected
  • NFC tap disabled
  • PIN verification fails

Child Cards

  • If parent blocked, child cards still work
  • Block child cards separately if needed

Errors


Unblock Card

Restore a blocked card

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

Block reason

reason
string
required
Example:

"Lost card"

pin
string
Example:

"1234"

Response

Card blocked

The response is of type object.