Skip to main content
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

Authorization
string
header
required

API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'

Body

application/json

Link card details

card_serial
string
required

Supports any alphanumeric: CARD0001, 48290173K, etc.

Example:

"OLIV0001"

pin
string
required
Example:

"1234"

subscriber_id
string
required
Example:

"subscriber-uuid"

Response

Card linked successfully

The response is of type object.