Skip to main content
POST
Allows super-agents to transfer float balance to their sub-agents.

Request

string
required
Bearer olive_live_xxx or Bearer eyJ... (JWT)

Body Parameters

string
required
Source agent (super-agent) UUID
string
required
Destination agent (sub-agent) UUID
string
required
Amount to transfer
string
required
Source agent’s 4-digit PIN
string
Transfer description

Response

boolean
Whether transfer succeeded
string
Transfer transaction ID
string
Super-agent’s new balance
string
Sub-agent’s new balance

Examples


Rules

Hierarchy

Only super-agent to own sub-agent transfers

Balance Check

Source must have sufficient float

Errors

Authorizations

Authorization
string
header
required

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

Body

application/json

Transfer details

amount
integer
required
sub_agent_id
string
required
super_agent_id
string

Optional - auto-detected from logged-in user if not provided

Response

OK

The response is of type object.