Skip to main content
POST
/
cards
/
child
Create child card
curl --request POST \
  --url https://olive-gateway-a6ba.onrender.com/api/v1/cards/child \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card_serial": "OLIV0002",
  "child_holder_name": "Jane Doe",
  "child_pin": "5678",
  "child_relationship": "daughter",
  "parent_subscriber_id": "parent-uuid",
  "pin": "1234"
}
'
{}

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Child card details

​
card_serial
string
required

Supports any alphanumeric: CARD0001, 48290173K, etc.

Example:

"OLIV0002"

​
child_holder_name
string
required
Example:

"Jane Doe"

​
child_pin
string
required
Example:

"5678"

​
child_relationship
string
required
Example:

"daughter"

​
parent_subscriber_id
string
required
Example:

"parent-uuid"

​
pin
string
required
Example:

"1234"

​
allocated_amount
integer

Amount in SLE (will be converted to cents internally)

Example:

200000

​
child_phone_number
string
Example:

"+23276123456"

​
daily_limit
integer

Amount in SLE (will be converted to cents internally)

Example:

25000

​
effective_date
string
Example:

"2025-10-20"

​
monthly_limit
integer

Amount in SLE (will be converted to cents internally)

Example:

250000

Response

Child card created

The response is of type object.