Incentives
A commission subplan can optionally have one or more incentives. An incentive is an additional commission that is paid when certain business conditions are met. Incentives can be used to encourage producers to provide certain types or amounts of business to the insurer.
In the base configuration of BillingCenter, there is only one kind of incentive: premium incentive. This is a policy-level incentive that stipulates the primary producer earns a higher commission rate when the policy period ends, expressed as an additional percent, if the total commissionable charges on the policy is equal to or greater than a given threshold.
For more information on incentives, see "Incentives" in Additional options for commission plans.
You can query for, create, modify, and delete premium incentives through Cloud API.
Querying for incentives
- GET
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/incentives
- GET
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/incentives/{incentiveId}
The following retrieves the incentives on a subplan:
GET /admin/v1/commission-plans/bc:134/commission-sub-plans/bc:199/incentives
Response{
"count": 1,
"data": [
{
"attributes": {
"application": "Policy",
"bonusPercentage": "5.00",
"description": "Any policy with commissionable charges over CA$50,000.00 qualifies for a 5% bonus commission",
"id": "bc:SUOHmuokMc2bl4A7f4UG6",
"name": "Policies over CA$50,000.00 (5%)",
"subtype": "PremiumIncentive",
"threshold": {
"amount": "50000.00",
"currency": "cad"
}
}
},
...
}
}
}
Create an incentive
- POST
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/incentives
subtype
- The type of incentive. In the base configuration, there are only premium incentives. Therefore, without additional configuration, the value for this field must be set to the string"PremiumIncentive"
for the call to succeed.threshold
- The threshold of the policy’s commissionable charges, as an amount/currency pair. If the premium is above this value, the incentive is activated.bonusPercentage
- The additional percent that is added to the general commission rate when the incentive is activated.
For example, the following request creates a premium incentive where the primary producer gets 3% bonus commission on policies with commissionable charges above $50,000.
POST /admin/v1/commission-plans/bc:134/commission-sub-plans/bc:199/incentives
{
"data": {
"attributes": {
"subtype": "PremiumIncentive",
"threshold": {
"amount": "50000",
"currency": "usd"
},
"bonusPercentage": "3"
}
}
}
"description": "Any policy with commissionable charges over $50,000.00 qualifies for a 5% bonus commission"
Modify an incentive
- PATCH
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/incentives/{incentiveId}
If the commission plan is not in use, you can update the threshold amount or the bonus percentage. You cannot change the subtype of the incentive or the currency. If the commission plan is in use, incentives cannot be modified.
For example, the following request body updates an incentive to have a 5% bonus percentage on policies with commissionable charges over $70,000.
{
"data": {
"attributes": {
"threshold": {
"amount": "70000",
"currency": "usd"
},
"bonusPercentage": "5"
}
}
}
Delete an incentive
- DELETE
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/incentives/{incentiveId}
The DELETE returns a success message with no response body.