curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Suspicious activity detected - multiple failed PIN attempts"
}'
{
"success": true,
"message": "Subscriber blocked successfully",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl"
}
{
"error": "Subscriber not found",
"code": "NOT_FOUND"
}
Subscribers
Block Subscriber
Block a subscriber account
POST
/
subscribers
/
{id}
/
block
curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Suspicious activity detected - multiple failed PIN attempts"
}'
{
"success": true,
"message": "Subscriber blocked successfully",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl"
}
{
"error": "Subscriber not found",
"code": "NOT_FOUND"
}
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
curl -X POST "https://demo.api.vultlocal.com/api/v1/subscribers/sub_abc123/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Suspicious activity detected - multiple failed PIN attempts"
}'
{
"success": true,
"message": "Subscriber blocked successfully",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl"
}
{
"error": "Subscriber not found",
"code": "NOT_FOUND"
}
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
| Reason Type | Example |
|---|---|
| Security | ”Multiple failed PIN attempts” |
| Fraud | ”Suspected fraudulent activity” |
| KYC | ”KYC documents not verified” |
| Compliance | ”AML screening flag” |
| Request | ”Customer requested block” |
Errors
| Status | Code | Description |
|---|---|---|
| 400 | MISSING_REASON | Reason is required |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 403 | FORBIDDEN | Insufficient permissions |
| 404 | NOT_FOUND | Subscriber not found |
| 409 | ALREADY_BLOCKED | Subscriber already blocked |
| 500 | INTERNAL_ERROR | Server error |
Related
Unblock Subscriber
Restore access to a blocked subscriber account
Authorizations
ApiKeyAuthBearerAuth
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Path Parameters
Subscriber ID
Body
application/json
Block reason
Example:
"Suspicious activity detected"
Response
Block successful
The response is of type object.
⌘I