curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Lost card - customer reported",
"pin": "1234"
}'
{
"success": true,
"message": "Card blocked successfully",
"card": {
"serial": "OLIV0001",
"status": "BLOCKED",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl",
"block_reason": "Lost card - customer reported"
}
}
{
"error": "Card not found",
"code": "CARD_NOT_FOUND"
}
Cards
Block Card
Block an NFC card from transactions
POST
/
cards
/
{serial}
/
block
curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Lost card - customer reported",
"pin": "1234"
}'
{
"success": true,
"message": "Card blocked successfully",
"card": {
"serial": "OLIV0001",
"status": "BLOCKED",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl",
"block_reason": "Lost card - customer reported"
}
}
{
"error": "Card not found",
"code": "CARD_NOT_FOUND"
}
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
curl -X POST "https://demo.api.vultlocal.com/api/v1/cards/OLIV0001/block" \
-H "Authorization: Bearer olive_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"reason": "Lost card - customer reported",
"pin": "1234"
}'
{
"success": true,
"message": "Card blocked successfully",
"card": {
"serial": "OLIV0001",
"status": "BLOCKED",
"blocked_at": "2025-01-20T14:45:00Z",
"blocked_by": "admin@olive.sl",
"block_reason": "Lost card - customer reported"
}
}
{
"error": "Card not found",
"code": "CARD_NOT_FOUND"
}
Block Reasons
| Reason | Description | Reversible |
|---|---|---|
| Lost | Customer lost card | No (issue new card) |
| Stolen | Card reported stolen | No |
| Fraud | Suspected fraud | Yes (after investigation) |
| Request | Customer requested | Yes |
| Damaged | Physical damage | No (issue new card) |
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
| Status | Code | Description |
|---|---|---|
| 400 | MISSING_REASON | Reason is required |
| 400 | INVALID_PIN | PIN verification failed |
| 401 | UNAUTHORIZED | Invalid API key |
| 404 | CARD_NOT_FOUND | Card serial not found |
| 409 | ALREADY_BLOCKED | Card already blocked |
| 500 | INTERNAL_ERROR | Server error |
Related
Unblock Card
Restore a blocked card
Authorizations
ApiKeyAuthBearerAuth
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Path Parameters
Card Serial Number
Body
application/json
Block reason
Response
Card blocked
The response is of type object.
⌘I