Skip to main content
POST
Blocking a subscriber prevents all transactions on their account and any linked cards.

Request

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

Path Parameters

string
required
Subscriber UUID (e.g., sub_abc123)

Body Parameters

string
required
Reason for blocking the account. This is logged for audit.

Response

boolean
Whether block succeeded
string
Result message

Examples


What Gets Blocked

Account Actions

  • All wallet transactions
  • P2P transfers
  • Cash-in/cash-out
  • PIN changes

Card Actions

  • All linked cards blocked
  • POS payments rejected
  • NFC tap disabled

Common Reasons


Errors


Unblock Subscriber

Restore access to a blocked subscriber account

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Subscriber ID

Body

application/json

Block reason

reason
string
required
Example:

"Suspicious activity detected"

Response

Block successful

The response is of type object.