Configuring OnApp Billing Service Module Estimated Reading Time: 3 Minutes The OnApp Billing service module integrates with your OnApp platform to bill your clients for their monthly usage. Once your OnApp usage service renews, your client’s usage stats and the total amount due for the previous period is calculated. The OnApp usage pricing and total due each month is determined by OnApp. Ubersmith simply retrieves the details for billing. Warning The OnApp Billing service module only integrates with the OnApp platform up to version 5.5. If you are using OnApp beyond version 5.5 or are integrating with OnApp for the first time, use the OnApp Billing Plugin. In order to begin billing for this service, you need to configure Ubersmith. Once all the necessary pieces have been configured, any current or new service based on the service plan will be ready. The configuration steps are as follows: Create a generic OnApp billing service plan Add the OnApp Billing service module to your service plan Configure the service module (below). Create an OnApp billing service Configure the service plan (below). Configure the service (below). Configuring the Service Module In the OnApp Hostname field, type your OnApp host name. In the OnApp Username field, type your OnApp user name. In the OnApp Password field, type your OnApp password. In the Request Timeout field, type your desired timeout in seconds. Using zero results in no timeout and is not recommended, because it can result in daily invoice runs being blocked if your OnApp host is unreachable. In the Show breakdown on invoice field, select Yes if you want to include the billing details sent from OnApp on your client’s invoice. Click Save or Save & New. Configuring the Service Plan The service plan can be configured in numerous ways depending on what OnApp services you offer. There are four different billing method options available in Ubersmith, VM resources only, all resources, vCloud resource pool, and CDN resource ID. If you primarily use only one of the four, such as only virtual machines, select that one. Alternatively, you could set up four different service plans, one for each billing method. Access the Service Plans Details page In the Pricing & Period Defaults section, click edit. The Edit Service Plan page appears. In the Post Renew field, select Yes to bill at the end of the service period. Click Update. In the Custom Fields Defaults section, click edit. The Edit Service Plan page appears. In the OnApp Billing section, for the OnApp Billing Method select one of the following. Click here to expand... User ID – VM resources only to use an OnApp user ID to bill your client for all related VMs. The VM resources includes disk space, CPU usage, etc. for all virtual servers, load balancers and CDN resources. See https://docs.onapp.com/apim/latest/users/get-user-billing-statistics for OnApp help. User ID - All resources to use an OnApp user ID to bill your client for VM resources and other non VM-related user resources such as ISOs, backups, OVAs and CDN. See https://docs.onapp.com/apim/latest/users/get-user-statistics for OnApp help. vCloud Resource Pool ID to bill a company or a user group for the amount of OnApp computes, data stores, and network resources for the whole resource pool. A vCloud resource pool with the desired user group and company billing plan must first be configured in OnApp. See https://docs.onapp.com/pages/viewpage.action?pageId=55119901 for OnApp help. CDN Resource ID to bill for the traffic a specific CDN resource pool used. See https://docs.onapp.com/display/CDN/View CDN Resource Billing Statistics for OnApp help. Ensure each OnApp Billing Applicable field is set to either Yes or Required. Click Update. Configuring the Service Before configuring your client’s individual services, ensure you have configured the service plan (above) these services are based on first. Access the Service Plans Details page In the Custom Fields Defaults section, click edit. The Edit Service page appears. In the OnApp Billing section, select one of the following. Click here to expand... In the OnApp ID field, enter the client’s corresponding OnApp ID to be used for the service. In the OnApp Billing Method field, select the service’s billing method. See Configuring the Service Plan (above) for more information on each method. Click Save.