Skip to main content
POST
/
api
/
v1
/
pos
/
verify-card
curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/pos/verify-card" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "card_serial": "OLIV0001"
  }'

{
  "valid": true,
  "subscriber_name": "John D.",
  "status": "ACTIVE",
  "card_type": "PARENT",
  "requires_pin": true
}
Used before a transaction to verify the card is active and display the subscriber’s name for confirmation.

​
Request

​
Authorization
string
required
Bearer olive_live_xxx

​
Body Parameters

​
card_serial
string
required
Card serial number
​
pin
string
Optional PIN to verify ownership immediately

​
Response

​
valid
boolean
Is card valid and active?
​
subscriber_name
string
Masked name (e.g., “John D.”)
​
status
string
Card status (ACTIVE, BLOCKED)
​
requires_pin
boolean
Whether PIN is required (always true for POS)

​
Examples

curl -X POST "https://olive-gateway-a6ba.onrender.com/api/v1/pos/verify-card" \
  -H "Authorization: Bearer olive_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "card_serial": "OLIV0001"
  }'

{
  "valid": true,
  "subscriber_name": "John D.",
  "status": "ACTIVE",
  "card_type": "PARENT",
  "requires_pin": true
}

​
Use Cases

Pre-Auth

Check card before entering amount

Identity

Verify card holder name matches id

​
Errors

StatusCodeDescription
404CARD_NOT_FOUNDCard does not exist
403CARD_BLOCKEDCard has been blocked
500INTERNAL_ERRORServer error