NFC cards are physical payment cards that link to subscriber wallets. OLIVE supports parent cards (full access) and child cards (limited/delegated access).
Card Types
Parent Card
Primary card linked to subscriber
- Full wallet access
- Can create child cards
- Required for most operations
Child Card
Delegated access card
- Daily spending limit
- For dependents/employees
- Separate PIN from parent
Endpoints
Link Card
POST /api/v1/cards/linkLink parent card to subscriberCreate Child
POST /api/v1/cards/childCreate child card with limitsGet Card
GET /api/v1/cards/{serial}Get card details by serialList Cards
GET /api/v1/cardsList all cards with filtersBlock Card
POST /api/v1/cards/{serial}/blockBlock card from transactionsUnblock Card
POST /api/v1/cards/{serial}/unblockRestore blocked cardUpload CSV
POST /api/v1/cards/upload-csvBulk upload cards from CSVCard Object
Card Status
Unassigned
Available for linking
Active
Ready for transactions
Blocked
Temporarily disabled
Lost
Permanently disabled
Card Lifecycle
1
Upload
Admin uploads cards via CSV with serial and MAC address
2
Assign
Card linked to subscriber as parent or child
3
Active
Card ready for POS payments and transactions
4
Block/Unblock
Card can be temporarily blocked if needed
Common Workflows
Link New Card
Link New Card
- Ensure card exists in system (uploaded via CSV)
- Call
POST /api/v1/cards/linkwith subscriber ID and card serial - Subscriber’s PIN is set on the card
- Card status changes to ACTIVE
Create Child Card
Create Child Card
- Parent must have a linked parent card
- Call
POST /api/v1/cards/childwith limits and child info - Child PIN is set (different from parent)
- Child can spend up to daily limit
Report Lost Card
Report Lost Card
- Customer reports lost card
- Call
POST /api/v1/cards/{serial}/blockwith reason “lost” - Card is permanently blocked
- Issue new card and link to subscriber
Bulk Card Import
Bulk Card Import
- Prepare CSV with columns: Serial No., MAC Address
- MAC supports 6-octet (AA:BB:CC:DD:EE:FF) or 7-octet formats
- Upload via
POST /api/v1/cards/upload-csv - Cards created with status “Unassigned”
Related
Subscriber Cards
List cards for a specific subscriber
POS Payment
Process payment with NFC card