/v1/operator/transfer-balance

Transfer balance to child operators

POST /v1/operator/transfer-balance

Enables an authenticated operator to transfer balance to its child operators. The operator must have sufficient balance to complete the transfer.

Headers

Name	Value
Authorization	Bearer <API_TOKEN>
Content-Type	application/json
Accept	application/json

Body

{
  "targetOperatorId": "sub_operator_11",
  "currency": "USD",
  "amount": 100,
  "remark": "Transfer for monthly budget"
}

Field	Data Type	Description	Mandatory
targetOperatorId	string	Unique identifier of the target (child or sub) operator receiving the transfer	Required
currency	string	Currency code of the transfer amount (e.g., USD)	Required
amount	number	Amount to be transferred to the target operator	Required
remark	string	Optional note or description for the transfer (e.g., purpose or reference)	Optional

Response

{
  "success": true,
  "message": "OK",
  "data": {
    "currency": "USD",
    "myPreBalance": 100,
    "myAfterBalance": 0,
    "targetPreBalance": 0,
    "targetAfterBalance": 100
  }

Field	Data Type	Description
success	boolean	Indicates whether the transfer operation was successful
message	string	Response message describing the result (e.g., OK)
data.currency	string	Currency used for the transfer
data.myPreBalance	number	Sender operator’s balance before the transfer
data.myAfterBalance	number	Sender operator’s balance after the transfer
data.targetPreBalance	number	Target operator’s balance before the transfer
data.targetAfterBalance	number	Target operator’s balance after the transfer