Skip to content
Reference
/
/
Top up an existing fund a...

Top up an existing fund account

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Top up an existing fund account

Security
oauth2ClientCredentials(Required scopes: investments:write)
Path
fundAccountIdstringrequired
Headers
Idempotency-Keystring

Required on write endpoints (POST). UUID per submission. Middleware dedupes for 24h.

org_wallet_refstring
business_idstringrequired
Bodyapplication/jsonrequired
amountnumberrequired

Top-up amount, native currency

Example:50000
curl -i -X POST \
  'https://developer.boyahq.com/_mock/v2/openapi/investments/accounts/{fundAccountId}/invest' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: string' \
  -H 'business_id: string' \
  -H 'org_wallet_ref: string' \
  -d '{
    "amount": 50000
  }'

Responses

Bodyapplication/json
referencestringrequired
Example:"inv_01HXYZ..."
statusstringrequired
Example:"PROCESSING"
Response
{
  "reference": "inv_01HXYZ...",
  "status": "PROCESSING"
}