Child accounts

Learn how to understand user and account management to design your application properly.

Voximplant application users are the end users of the application, and Voximplant developers can control each user account balance by setting the parent_accounting parameter to false (via the AddUser and SetUserInfo methods) or specifying this setting in the control panel (the Separate account balance checkbox) while creating/editing the app user.

It is possible to transfer funds from the developer account to an app user account and back via the TransferMoneyToUser method.

Let us imagine that a developer is building a Cloud PBX service where every company has its own account balance and controls users' account balance (if required). The developer has their account balance where they put funds to divide them up among the companies.

For this type of service, Voximplant offers child accounts that are created by the developer with the help of their parent account credentials. To create a child account, use the AddAccount method.

Child Accounts operate as standalone entities, they do not share applications, scenarios, and balances with each other. They, however, have access to the parent's scenarios. Creating a child account is handy when you need to separate your customers, so each child account can represent each customer, but there is only one parent account "to rule them all".

In terms of balance, transfer funds to child accounts' users via the aforementioned TransferMoneyToUser method.

Thus, the chain of events for adding the funds looks like this: Developer's card/wire → Child account balance → App user account balance.

Q: What is the difference between users, subusers, service accounts, and child accounts?
A: Users are necessary to log in to client applications and use calls, conferences, and messaging. They may have their own balances to control the spending. Subusers are necessary to give your developers limited access to your Voximplant control panel. They have different roles and different access levels to your account. Service accounts are necessary to provide API access to your account. They have different roles and different access levels to management API. Child accounts are independent subaccounts within your main account that have independent applications, scenarios, and balances but have access to your main account scenarios. You can use child accounts in Cloud PBX services to divide the customers between different accounts.

Q: I have 3 child accounts. How do I transfer an incoming call from child account 1 to a user from child account 2?
A: You can receive the call on the first child account, then transfer the call to the second child account's user via the callSIP method. Use the username as the user part of the SIP address, and the application address as a domain part of your SIP address. For example: user@application.account.voximplant.com. You also need to whitelist the following IP addresses from your second child account.

Q: Can I use applications from my parent account?
A: No. Child accounts have access to the parent account's scenarios, but they do not have access to the parent account's application. You need to create an application on your child account.