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"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
card_serial: 'OLIV0002',
child_holder_name: 'Jane Doe',
child_pin: '5678',
child_relationship: 'daughter',
parent_subscriber_id: 'parent-uuid',
pin: '1234'
})
};
fetch('https://olive-gateway-a6ba.onrender.com/api/v1/cards/child', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://olive-gateway-a6ba.onrender.com/api/v1/cards/child"
payload = {
"card_serial": "OLIV0002",
"child_holder_name": "Jane Doe",
"child_pin": "5678",
"child_relationship": "daughter",
"parent_subscriber_id": "parent-uuid",
"pin": "1234"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{}{}Cards
Create child card
Create a child card linked to parent subscriber with spending limits. Requires parent’s PIN for authentication and a separate PIN for the child’s card transactions. The child will use their own PIN when making payments for security.
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"
}
'const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
card_serial: 'OLIV0002',
child_holder_name: 'Jane Doe',
child_pin: '5678',
child_relationship: 'daughter',
parent_subscriber_id: 'parent-uuid',
pin: '1234'
})
};
fetch('https://olive-gateway-a6ba.onrender.com/api/v1/cards/child', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://olive-gateway-a6ba.onrender.com/api/v1/cards/child"
payload = {
"card_serial": "OLIV0002",
"child_holder_name": "Jane Doe",
"child_pin": "5678",
"child_relationship": "daughter",
"parent_subscriber_id": "parent-uuid",
"pin": "1234"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){}{}{}Authorizations
ApiKeyAuthBearerAuth
API Key for third-party integrations (WhatsApp, Smart PAY, VULT). Format: 'Bearer olive_live_xxxxxxxxxxxxx'
Body
application/json
Child card details
Supports any alphanumeric: CARD0001, 48290173K, etc.
Example:
"OLIV0002"
Example:
"Jane Doe"
Example:
"5678"
Example:
"daughter"
Example:
"parent-uuid"
Example:
"1234"
Amount in SLE (will be converted to cents internally)
Example:
200000
Example:
"+23276123456"
Amount in SLE (will be converted to cents internally)
Example:
25000
Example:
"2025-10-20"
Amount in SLE (will be converted to cents internally)
Example:
250000
Response
Child card created
The response is of type object.
⌘I