Cards
Link Card
Link a parent NFC card to a subscriber account
POST
Linking a card associates it with a subscriber’s wallet. The subscriber’s PIN is used for card transactions.
Request
string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)Body Parameters
string
required
Subscriber UUID to link the card to
string
required
Card serial number (e.g.,
OLIV0001)string
required
Subscriber’s 4-digit PIN for verification
Response
boolean
Whether linking succeeded
string
Result message
object
Linked card details
Examples
Prerequisites
Card Exists
Card must be uploaded via CSV first
Card Unassigned
Card status must be “Unassigned”
Errors
Authorizations
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Body
application/json
Link card details
Response
Card linked successfully
The response is of type object.